Images
tinytales_images books:read
List coloring images, check generation status, or get a 15-minute preview URL (no image bytes). Actions: list, status, preview.
Actions: list, status, preview.
01Access
The signed-in customer must have approved books:read. Calls stay inside that account.
02Annotations
The tool only loads data that already belongs to the signed-in account.
The change can be removed later with tinytales_delete, or it only adds data.
This tool only reads or changes the signed-in TinyTales account. It does not post to the public internet or to other people’s services.
Repeating the same call does not stack a second effect.
03Input
Which action to run: list, status, preview.
Optional list filter: pending, processing, completed, or failed.
Page size from 1 to 50. Defaults to 20.
Opaque cursor from the previous page. Omit for the first page.
Image id for status or preview.
Comma-separated image ids, up to 50, for a batch status check.
json returns structured data. markdown returns the same data as a short readable summary. Defaults to json.
04Output
True when the underlying TinyTales route accepted the call.
One-line result for the model to read.
Present when ok is false. Names the failed state and the next action to call.
True when another page exists.
Pass as cursor to fetch the next page.
Total matching rows when the route can count them.
Image list or status JSON.
Time-limited preview URL for preview.
Unix expiry time in seconds.
05Errors
- Purchase required
- Unauthorized
- Image not found
06Example request
{
"action": "list",
"status": "completed",
"limit": 20
}07Example response
{
"ok": true,
"summary": "4 completed images.",
"has_more": false,
"total_count": 4
}