check_job
Read-onlyIdempotent
Check the status/result of a job previously returned by generate_image, generate_video, generate_video_from_image, or generate_video_with_reference.
Besides status/result it reports PROGRESS, so you can tell the person something
truthful instead of "still waiting":
queue_position — how many jobs are ahead (1 = next to be picked up); only while queued
queue_seconds — how long it sat in the queue
run_seconds — how long the generation itself has been running
account_used — which Google account it ran on, once finished
hint — the same thing in one human sentence
A job that is queued behind others needs patience; one that has been running far longer
than its model's typical time (see list_models) is the one worth reporting as stuck.
Once status is 'done', SAVE THE FILES: the response carries `download_urls` (no auth
header needed) and `save_as` (filenames). Write them into the user's project — e.g.
./media/<save_as> — and tell them where. The URLs expire within the hour, and the
server's own copy can be reclaimed when its disk fills; the copy in their project is
the one that lasts.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | ||
| include_preview | No |