Seedance 2.0 API

Using the requests library to create a text-to-video task and poll for results.

import requests
import time

API_KEY = "your-api-key-here"
BASE_URL = "https://open.volcengineapi.com/api/v3/contents/generations/tasks"

# Step 1: Create a text-to-video generation task
response = requests.post(
    f"{BASE_URL}/seedance/v2/text_to_video",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.",
        "resolution": "720p",
        "duration": 5,
        "aspect_ratio": "16:9",
        "fps": 24,
    },
)

task = response.json()
task_id = task["data"]["task_id"]
print(f"Task created: {task_id}")

# Step 2: Poll for task completion
while True:
    status_resp = requests.get(
        f"{BASE_URL}/{task_id}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    status = status_resp.json()
    state = status["data"]["status"]

    if state == "completed":
        video_url = status["data"]["output"]["video_url"]
        print(f"Video ready: {video_url}")
        break
    elif state == "failed":
        print(f"Generation failed: {status['data']['error']}")
        break
    else:
        print(f"Status: {state}, waiting...")
        time.sleep(10)

Command-line examples for creating a task and checking status.

# Step 1: Create a text-to-video generation task
curl -X POST \
  https://open.volcengineapi.com/api/v3/contents/generations/tasks/seedance/v2/text_to_video \
  -H "Authorization: Bearer your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "fps": 24
  }'

# Response: {"data": {"task_id": "task_abc123"}}

# Step 2: Check task status
curl -X GET \
  https://open.volcengineapi.com/api/v3/contents/generations/tasks/task_abc123 \
  -H "Authorization: Bearer your-api-key-here"

# Response when complete:
# {"data": {"status": "completed", "output": {"video_url": "https://..."}}}

Using the Fetch API to integrate Seedance into web applications.

const API_KEY = 'your-api-key-here';
const BASE_URL = 'https://open.volcengineapi.com/api/v3/contents/generations/tasks';

// Step 1: Create a text-to-video generation task
async function generateVideo(prompt) {
  const response = await fetch(
    `${BASE_URL}/seedance/v2/text_to_video`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        prompt,
        resolution: '720p',
        duration: 5,
        aspect_ratio: '16:9',
        fps: 24,
      }),
    }
  );

  const task = await response.json();
  const taskId = task.data.task_id;
  console.log(`Task created: ${taskId}`);

  // Step 2: Poll for task completion
  while (true) {
    const statusResp = await fetch(
      `${BASE_URL}/${taskId}`,
      { headers: { 'Authorization': `Bearer ${API_KEY}` } }
    );
    const status = await statusResp.json();
    const state = status.data.status;

    if (state === 'completed') {
      console.log(`Video ready: ${status.data.output.video_url}`);
      return status.data.output.video_url;
    } else if (state === 'failed') {
      throw new Error(`Generation failed: ${status.data.error}`);
    }

    console.log(`Status: ${state}, waiting...`);
    await new Promise((r) => setTimeout(r, 10000));
  }
}

// Usage
generateVideo(
  'A young woman in a flowing red dress walks along a moonlit beach, gentle waves lapping at her feet. Smooth dolly-in, cinematic lighting, film grain.'
).then((url) => console.log('Download:', url));