{"uid":"cap_RBtjq99y9EJc7x4f1kPP6","slug":"video-withzero-xyz-poll-video-generation-job-status-5fb07d53","name":"Poll Video Generation Job Status","description":"","url":"https://video.withzero.xyz/api/v1/jobs/{id}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["job_id","status","model"],"properties":{"url":{"type":"string","description":"Public URL of the finished video. Present when status is completed."},"error":{"type":"string","description":"Failure reason. Present when status is failed."},"model":{"type":"string","description":"The model generating the video."},"job_id":{"type":"string","description":"The job id being polled."},"status":{"enum":["in_progress","completed","failed"],"type":"string","description":"Generation status."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"1.00","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_3dQCL3iabVTSpBvDdwuGx","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"video.withzero.xyz","brandSlug":"video-withzero-xyz-mpp","brandBaseUrl":"https://video.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Retrieves the current status and result URL of an async video generation job by job ID","exampleAgentPrompt":"Can you check the status of my video generation job with ID 'job_abc123' and let me know if it's done — and if so, give me the video URL?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the job_id, current status (in_progress, completed, or failed), the model being used, and either a public video URL (when completed) or an error reason (when failed).","failureModes":["Job ID not found — returns an error or 404 if the ID is invalid or expired","Status is 'failed' with an error string describing why generation failed","Job still in_progress — agent must retry polling until status changes","Network timeout if the polling service is temporarily unavailable"],"whenToPreferThis":"Use this endpoint after calling one of the video generation endpoints (Sora, Veo, Kling) that return a job_id. This is the correct polling endpoint to check async job completion and retrieve the final video URL. Prefer this over re-submitting a generation request — it is read-only and idempotent.","instructions":"# Free status read for an async video job.\n\n## Workflow\nThis is the state-read endpoint for the async video generators on this host.\n- Submit a job first: POST /api/v1/videos/{model} (e.g. /veo-3.1, /veo-3.1-fast, /sora-2-pro, /kling-v3.0-pro) returns the `job_id` to poll here.\n- Poll until `status` is `completed` (read `url` for the finished video) or `failed` (read `error`). `in_progress` means keep polling.\n\n## Contract\n- Free and idempotent — safe to poll repeatedly; never charges. Do NOT re-submit the generation to retry; just keep polling this id.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":30,"lastUsedAt":"2026-07-28T22:30:15.546Z","lastSuccessfullyRanAt":"2026-07-22T20:22:11.094Z","lastHealthCheckAt":"2026-10-07T06:30:36.609Z","isFirstParty":true,"canonicalSlug":"video-withzero-xyz-poll-video-generation-job-status-5fb07d53"}