tinytales_upload_book_photo tinytales:write
Add one photo to a draft book and queue a coloring page. Accepts a base64 image up to 10 MB in JPEG, PNG, WebP, or HEIC. The free generation quota applies. This spends quota and does not delete anything.
The signed-in customer must have approved tinytales:write. Calls stay inside that account.
The tool creates or updates records in the signed-in account.
The upload adds a page and spends generation quota. The page can be deleted afterward. It does not erase the book.
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 call can create another record or spend quota again.
Book id returned by tinytales_list_books or tinytales_create_book.
File name including an extension, such as photo.jpg.
MIME type: image/jpeg, image/png, image/webp, or image/heic.
Base64-encoded image bytes, without a data: prefix. Maximum decoded size is 10 MB.
json returns structured data. markdown returns the same data as a short readable summary. Defaults to json.
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 tool to call.
{
"book_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"filename": "lake.jpg",
"media_type": "image/jpeg",
"image_base64": "<base64>"
}{
"ok": true,
"summary": "Photo accepted and queued for a coloring page."
}