Vidu Q3

1. Integration status

Catalog-backed model IDs: viduq3, viduq3-pro, viduq3-pro-fast

Check the authenticated model list for availability to your API key. Catalog presence does not guarantee capacity or permission for every account.

curl https://api.seedance.ch/v1/models \
  -H "Authorization: Bearer $LITHOVAS_API_KEY"

2. Authentication

Use a Lithovas API key in the Authorization header. Keep it on your server, not in browser code or source control.

export LITHOVAS_API_KEY="YOUR_API_KEY"

3. Request contract

Submit a JSON video request to POST /v1/videos. Use an exact model ID from the list above. The minimal example omits optional duration, resolution and reference fields instead of assuming limits shared by different models.

curl https://api.seedance.ch/v1/videos \
  -H "Authorization: Bearer $LITHOVAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "viduq3", "prompt": "A cinematic scene at sunset"}'

4. Results and polling

Store the returned task ID. Poll the task until it completes; do not resubmit while it is queued. Download only after completion.

curl "https://api.seedance.ch/v1/videos/$TASK_ID" \
  -H "Authorization: Bearer $LITHOVAS_API_KEY"

curl "https://api.seedance.ch/v1/videos/$TASK_ID/content" \
  -H "Authorization: Bearer $LITHOVAS_API_KEY" \
  -o result.mp4

5. Errors and next steps

For authenticated API calls, check the returned error message: 401 indicates invalid or missing credentials; 429 calls for backoff. For unavailable-model or validation failures, verify the exact model and its supported contract before retrying.

Use the live catalog to choose an integrated model. Model-local request history is separate from these documentation examples.