get_ad_job
Read-onlyIdempotent
Check an ad job: stage and percent while it renders, then the finished video URL, the storyboard sheet, duration, size and the credits charged. Poll every 15 seconds after generate_ad; stop after 15 minutes. SIGN-IN REQUIRED: connect this server with OAuth (the host prompts for it), or add an API key header "Authorization: Bearer acd_live_…" created at https://aicontentdrop.com/settings/integrations.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job_id returned by generate_ad. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Present only when a succeeded job's charge could not be applied to the account. | |
| error | No | ||
| stage | No | storyboard | rendering | done, while known. | |
| job_id | Yes | ||
| status | Yes | ||
| percent | No | ||
| next_step | Yes | ||
| video_url | No | The finished ad with burnt-in captions. Present only when succeeded. | |
| size_bytes | No | ||
| studio_url | No | The job's page in the studio on AI Content Drop. | |
| credits_used | Yes | Credits charged for this job when the record reports them; null when a succeeded job's record does not carry the figure (credits_quoted from generate_ad is the ceiling). 0 while running, when failed, or when the charge could not be applied (then note says so). | |
| duration_seconds | No | ||
| retry_after_seconds | No | Present while the job is not terminal. | |
| storyboard_sheet_url | No | The storyboard sheet image, when the run produced one. |