Video generation

ru-llm exposes video generation (doubao-seedance-2-0-260128) through an asynchronous, job-based endpoint: you submit a prompt, poll for the job, then download the result.

Preview — not yet live

The video endpoint is documented here to its intended contract, but /v1/video/generations is not yet mounted in the gateway router. The live routes today are /v1/chat/completions, /v1/messages, and /v1/models. The exact response shape may change to match the Seedance handler that ships; treat this as the target contract.

Flow

1. Submit a generation job — POST /v1/video/generations, returns a task_id.
2. Poll the job — GET /v1/video/generations/{task_id} until status is succeeded.
3. Download the result — fetch result_url from the completed job.

1. Submit

curl https://api.ru-llm.relay2.xyz/v1/video/generations \
  -H "Authorization: Bearer sk-ru-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "prompt": "A timelapse of clouds over a mountain range at sunrise",
    "duration": 5
  }'

{ "task_id": "vid_abc123", "status": "queued" }

2. Poll

curl https://api.ru-llm.relay2.xyz/v1/video/generations/vid_abc123 \
  -H "Authorization: Bearer sk-ru-YOUR_KEY"

{ "task_id": "vid_abc123", "status": "succeeded", "result_url": "https://.../vid_abc123.mp4" }

status progresses queued → running → succeeded (or failed). Poll every few seconds.

3. Download

curl -L "https://.../vid_abc123.mp4" -o out.mp4

Note

Rendering takes several minutes, so always poll rather than blocking on a single call. The result_url is time-limited (~24h) — download and store the file promptly; do not treat the URL as permanent.

Billing

Seedance is billed per the doubao-seedance-2-0-260128 rate on the Models & Pricing page. The charge applies when the job completes successfully; failed jobs are not billed.

Troubleshooting

Symptom	Cause	Fix
404 Not Found	Endpoint not yet mounted (see preview note)	Use chat/messages until the video surface ships.
Job stuck running	Long render	Keep polling; renders take minutes.
result_url 403/expired	URL past its ~24h window	Re-submit the job to regenerate.
402 Payment Required	Zero balance	Top up in the console → Billing.