Browse documentation
MCP

Jobs and results

TrueCut creation is asynchronous: submit, poll, then use output URLs.

Lifecycle

Example
queued → running → succeeded
                 ↘ failed
queued/running → canceled

Submission returns a job ID, credit cost, status, and a hint to poll with get_generation. Finished jobs include output asset URLs and thumbnails.

Polling guidance

  • Poll every 3–10 seconds; do not create a replacement merely because a job is still running.
  • Treat failed and canceled as terminal states.
  • Use list_generations to recover after a client restart.
  • Output URLs belong to the authenticated account; never infer IDs from another account.