Seedance 2.5 API

Server-side example: create a text-to-video task, then query its status. Repeat the query until the task succeeds or fails.

import os
import requests

URL = "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks"
headers = {"Authorization": f"Bearer {os.environ['ARK_API_KEY']}"}
response = requests.post(URL, headers=headers, json={
    "model": "doubao-seedance-2-5-260628",
    "content": [{"type": "text", "text": "A paper boat floats down a quiet stream at sunrise."}],
    "resolution": "1080p",
    "duration": 30,
    "ratio": "16:9",
    "generate_audio": True,
}, timeout=60)
response.raise_for_status()
task_id = response.json()["id"]
print("Task created:", task_id)

# Query again later if status is queued or running.
result = requests.get(f"{URL}/{task_id}", headers=headers, timeout=60)
result.raise_for_status()
task = result.json()
print("Status:", task["status"])
if task["status"] == "succeeded":
    print("Video:", task["content"]["video_url"])
elif task["status"] in ("failed", "expired"):
    print("Task ended:", task.get("error", task["status"]))

Server-side example: create a text-to-video task, then query its status. Repeat the query until the task succeeds or fails.

# Set ARK_API_KEY in your environment before running.
curl --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "A paper boat floats down a quiet stream at sunrise. Slow tracking shot, soft light."
    }
  ],
  "resolution": "1080p",
  "duration": 30,
  "ratio": "16:9",
  "generate_audio": true
}'

# Copy the returned id into TASK_ID, then query the task.
TASK_ID="replace-with-returned-id"
curl --fail-with-body \
  "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Authorization: Bearer $ARK_API_KEY"
# status: queued / running / succeeded / failed / expired
# On success, the video URL is in content.video_url.

Server-side example: create a text-to-video task, then query its status. Repeat the query until the task succeeds or fails.

// Node.js server-side example. Keep ARK_API_KEY out of browser code.
const url = 'https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks';
const apiKey = process.env.ARK_API_KEY;
if (!apiKey) throw new Error('Set ARK_API_KEY before running this example');
const headers = { Authorization: `Bearer ${apiKey}` };
const response = await fetch(url, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'doubao-seedance-2-5-260628',
    content: [{ type: 'text', text: 'A paper boat floats down a quiet stream at sunrise.' }],
    resolution: '1080p',
    duration: 30,
    ratio: '16:9',
    generate_audio: true,
  }),
});
if (!response.ok) throw new Error(`Create failed: ${response.status}`);
const { id } = await response.json();
console.log('Task created:', id);

// Query again later if status is queued or running.
const result = await fetch(`${url}/${id}`, { headers });
if (!result.ok) throw new Error(`Query failed: ${result.status}`);
const task = await result.json();
console.log('Status:', task.status);
if (task.status === 'succeeded') console.log('Video:', task.content.video_url);
if (['failed', 'expired'].includes(task.status)) console.error(task.error ?? task.status);