Skip to main content
AI VIDEO GENERATION API

Add Seedance video generation with one API

An asynchronous video generation service for developers. Submit a task, poll its status, and receive an object-storage video URL when it completes.

Last updated
OpenAI Video style
Create a task with POST /v1/videos and query the result with GET /v1/videos/{id}.
Asynchronous jobs
Receive a task ID immediately and follow queued, in_progress, completed, and failed states.
Direct video URLs
Read metadata.url after completion instead of constructing an object-storage path yourself.

Publicly listed models

The public catalog currently lists seedance2.0, seedance2.5, seedance2.0-fast, and seedance2.0-mini on the openai-video endpoint. Always confirm availability with the current API key.

ModelGeneration modesEndpoint
seedance2.0Text, first/last frame, referencesPOST /v1/videos
seedance2.5Text, first/last frame, referencesPOST /v1/videos
seedance2.0-fastAvailability depends on the accountPOST /v1/videos
seedance2.0-miniAvailability depends on the accountPOST /v1/videos

From request to video

  1. Create an API keySign in and create a model API key for the server.
  2. Submit a taskSend a model, prompt, and optional references to /v1/videos.
  3. Poll statusQuery every 3 to 5 seconds until completed or failed.
  4. Read the resultDownload the video from metadata.url.
Create a video taskbash
curl --request POST "https://ling-light.com/v1/videos" \
  --header "Authorization: Bearer $VIDEO_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $(uuidgen)" \
  --data '{
    "model": "seedance2.0",
    "prompt": "An orange cat watching rain from a windowsill, slow camera push-in",
    "seconds": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'
Quickstart
Go from an API key to your first video task.
Tasks and errors
Handle polling, terminal states, idempotency, and rate limits.
Seedance 2.0
Generation modes, reference limits, and request examples.
Seedance 2.5
Higher reference limits through the same task API.