Skip to main content
GET
/
openai
/
v1
/
videos
/
{id}
curl https://api.lumenfall.ai/openai/v1/videos/video_abc123 \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "id": "video_abc123",
  "object": "video",
  "created_at": 1702345678,
  "completed_at": null,
  "expires_at": null,
  "status": "in_progress",
  "model": "sora-2",
  "prompt": "A capybara lounging in a hot spring, steam rising gently, slow camera pan",
  "seconds": "10",
  "size": "1920x1080",
  "output": null,
  "error": null,
  "metadata": {
    "model": "sora-2",
    "executed_model": "openai/sora-2",
    "provider": "openai",
    "provider_name": "OpenAI",
    "cost_estimate": 0.21,
    "cost_currency": "USD"
  }
}
Retrieve the current status and output of a video generation request. Use this endpoint to poll for completion after submitting a video with POST /v1/videos.

​
Path parameters

​
id
string
required
The ID of the video to retrieve (returned from the generate endpoint).

​
Response

​
id
string
Unique identifier for the video.
​
object
string
Always "video".
​
created_at
integer
Unix timestamp of when the video was created.
​
completed_at
integer
Unix timestamp of when the video finished generating. null until completed.
​
expires_at
integer
Unix timestamp of when the video output URL will expire. null until completed.
​
status
string
The generation status. One of queued, in_progress, completed, or failed.
​
model
string
The model used for generation.
​
prompt
string
The prompt used to generate the video.
​
seconds
string
The video duration.
​
size
string
Output dimensions as "WIDTHxHEIGHT" (e.g., "1920x1080") or aspect ratio (e.g., "16:9").
​
output
object
The generated video output. Only present when status is completed.
​
error
object
Error details. Only present when status is failed.
​
metadata
object
Metadata about the request execution, including cost. See Billing.
curl https://api.lumenfall.ai/openai/v1/videos/video_abc123 \
  -H "Authorization: Bearer $LUMENFALL_API_KEY"

{
  "id": "video_abc123",
  "object": "video",
  "created_at": 1702345678,
  "completed_at": null,
  "expires_at": null,
  "status": "in_progress",
  "model": "sora-2",
  "prompt": "A capybara lounging in a hot spring, steam rising gently, slow camera pan",
  "seconds": "10",
  "size": "1920x1080",
  "output": null,
  "error": null,
  "metadata": {
    "model": "sora-2",
    "executed_model": "openai/sora-2",
    "provider": "openai",
    "provider_name": "OpenAI",
    "cost_estimate": 0.21,
    "cost_currency": "USD"
  }
}