get_image

pro.aicut/aicut · Verify this server

Returns the current state of one image generation on the signed-in account. This is a SINGLE, IMMEDIATE read - it does not wait for anything. WHEN: only when you need one job's raw fields right now - what it cost, whether it was refunded, why it failed. It is NOT how you wait for a generation and it is NOT how you show one to the user. TO WAIT for a running image, call `wait_for_generation` instead: it waits server-side for up to 15 seconds per call, so it costs a fraction of the calls that polling this tool in a loop would. You do NOT need this to show an image: `generate_image` already put the aicut card up, and `show_generation` brings back an earlier one. Do not poll this tool repeatedly. TIMING: an image usually finishes in under 90 seconds, and can take up to about 4 minutes. `generate_image` waits about 20 seconds for it server-side; if it returns while the image is still `processing`, call `wait_for_generation` rather than waiting in a timer or a background shell. `status` is one of `queued` (accepted, not started), `processing` (running), `succeeded` (the `url` field is a public link to the finished image), or `failed` (terminal - `error.message` says why, and nothing further will arrive). The `url` is public and needs no credentials, so it can be given to the user directly. OUTPUT: this returns JSON for you to read. When you report back to the user, give them the media URL plus a one-line summary. Do not paste the raw JSON, job ids, or internal field names into the conversation.