Image to Video

Poll an image-to-video job

Returns the current job status and, when status is completed, a video_url.

Cadence: poll every 2–5 seconds. Status calls are not billed and not rate-limited at typical polling rates.

Typical completion time: 30–90 seconds for a 720p / 5s clip. Set client timeouts to ~5 minutes (90 polls at 3s) to absorb queue spikes.

Terminal states: completed (with result.video_url) and failed (with result.error populated). After a terminal state, the request_id remains addressable for roughly 24 hours. The video_url is served from a CDN and expires about 24 hours after generation — download and re-host it if you need long-term storage.

Error location on failure: the failure reason lives at result.error (string), with the envelope error field set to null. The top-level status boolean is true for any successful status fetch — the job-level outcome is in result.status.

get/api/image-to-video/{request_id}/status

Request

  • Base URL
    https://open.eternalai.org
  • Auth
    • HTTP bearer
    • or API key in header api-key

Path parameters

request_idstring uuid required

The request_id returned by the submit endpoint.

Response

Current job state.

statusboolean
errorstring nullable

Example response

{
  "status": true,
  "result": {
    "request_id": "9a4f1c84-2bb3-4d29-a4e1-7c0d3b8f5a91"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.