job_status
Retrieve results for pending generation jobs by passing the original job handles. Get finished URLs, re-check pending ones, or report terminal failures without creating new jobs.
Instructions
Retrieve a long-running generation that was submitted earlier but hasn't finished — any result from a generation tool that came back as {status:"pending", ...} (a job handle, not media). Pass the exact pending handle object(s) in jobs; NEVER re-submit a pending job with the tool that created it — that starts (and bills) a new one. Each job comes back one of three ways: finished (a hosted URL plus a local file path); still pending ({status:"pending", ...}), in which case call job_status again with the same handle after a short wait; or failed, carrying ok: false and an error. A failed job is terminal — it will never finish, so report the error and never poll or re-submit that handle. A batch can mix all three, so read every entry in results rather than the top-level counters alone. This works for any kind of pending generation and only rejoins an existing job — it neither starts nor bills a new one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| jobs | Yes | The pending job handle object(s) to retrieve — each exactly as returned by a prior video_generate / job_status call. Add more than one to retrieve a batch in one call. |