Images

Daily image · Mountains

Calling it

This is your own data, so a call has to say who you are. Make a token at /token and send it as a header.

curl -H "Authorization: Bearer $MU_TOKEN" \
  https://micro.mu/api/v1/images/daily

The same method over MCP, which is what an agent speaks: images_daily. The answer is identical.

How every call behaves →

Methods

GET /api/v1/images/daily

Retrieve the current daily image or a date

Needs an account.

Argument	Type	Description
`date`	string	YYYY-MM-DD; omitted for the current daily image

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://micro.mu/api/v1/images/daily"

date

POST /api/v1/images/delete

Delete an image you own

Needs an account. Changes something, so POST only. Withheld from the agent — a person or a program only.

Argument	Type	Description
`id` *	string

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://micro.mu/api/v1/images/delete

id *

19 creditsPOST /api/v1/images/generate

Generate an image from a text prompt and return its URL

Needs an account. Changes something, so POST only. Draws 19 credits per call, or accepts payment.

Argument	Type	Description
`prompt` *	string	What the image should depict

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"prompt"}' \
  https://micro.mu/api/v1/images/generate

prompt *

Costs 19 credits

GET /api/v1/images/get

Retrieve accessible image metadata and URL

Needs an account.

Argument	Type	Description
`id` *	string

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://micro.mu/api/v1/images/get?id=id"

id *

GET /api/v1/images/list

List stored images or the daily archive with pagination

Needs an account.

Argument	Type	Description
`scope`	string	mine, public, all (own plus public), or daily; defaults to public
`limit`	number	Page size, default 20, maximum 100
`cursor`	string	Next cursor from the previous page; keep query and scope unchanged

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://micro.mu/api/v1/images/list"

scopelimitcursor

POST /api/v1/images/search

Search accessible stored images by title, description, prompt and tags; public by default

Private search terms belong in a POST body. Needs an account.

Argument	Type	Description
`scope`	string	public, mine, all, or daily; defaults to public
`cursor`	string
`query` *	string	What the image should show, in words
`limit`	number	Max results (default 20)

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"query"}' \
  https://micro.mu/api/v1/images/search

scopecursorquery *limit

POST /api/v1/images/share

Explicitly publish or unpublish your image

Needs an account. Changes something, so POST only. Withheld from the agent — a person or a program only.

Argument	Type	Description
`id` *	string
`public`	boolean	Explicitly publish or unpublish this image

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://micro.mu/api/v1/images/share

id *public

POST /api/v1/images/update

Edit metadata on an image you own

Needs an account. Changes something, so POST only.

Argument	Type	Description
`id` *	string
`title`	string
`description`	string
`tags`	array

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://micro.mu/api/v1/images/update

id *titledescriptiontags

POST /api/v1/images/upload

Upload a private raster image

Needs an account. Changes something, so POST only.

Argument	Type	Description
`data` *	string	Base64 PNG, JPEG or GIF; at most 512 KB decoded and 8 megapixels; browser uploads support 8 MB
`description`	string	Image caption, at most 1000 characters

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"data":"data"}' \
  https://micro.mu/api/v1/images/upload

data *description

The same methods are tools over MCP, and every service on this instance is in one reference.