Skip to main content

Check Video Status

Video generation is asynchronous. A submit call to /generate/text-video or /generate/image-video returns a taskId immediately. Poll this endpoint until status is success, then read the video url.

GET /generate/video-status

Poll task status. Query params: taskId, outputType (url|binary).

Headers​

HeaderRequiredValue
x-api-keyYesYOUR_API_KEY

Query parameters​

ParameterRequiredDefaultDescription
taskIdYes—The task ID from the create response.
outputTypeNourl"url" returns JSON with a hosted video URL; "binary" returns the raw video file.

Examples​

curl "https://api.imagegpt.online/generate/video-status?taskId=TASK_ID&outputType=url" \
-H "x-api-key: YOUR_API_KEY"

Response example​

outputType: url

Returns JSON. status is "waiting" while rendering, then "success" with a hosted video url once done.

{
"success": true,
"status": "success",
"url": "https://...mp4"
}

outputType: binary

Returns the raw video file directly once it's ready (no JSON wrapper).

const blob = await response.blob();
const url = URL.createObjectURL(blob);

Playground​

Paste a taskId from a video submit call and fetch its current status. Your key is used only in your browser and is never stored.

note

Video rendering can take anywhere from several seconds to a few minutes depending on duration, resolution, and model. Poll on an interval (e.g. every 3-5s) rather than in a tight loop.