Документация Seedance 2.0 API

Полное руководство по интеграции Seedance 2.0 API генерации видео в ваши приложения.

API v1.0 Base URL: https://seedanceapi.org/v1

Быстрый старт

bash

curl -X POST 'https://seedanceapi.org/v1/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8"
  }'

Аутентификация

Все запросы к API требуют аутентификации с использованием Bearer токена в заголовке Authorization.

Важно: Вы можете получить свой API ключ со страницы API Keys в вашей панели управления. → Получить API ключ

http

Authorization: Bearer YOUR_API_KEY

Цены

480p

480p Разрешение

Быстрая генерация, подходит для превью и черновиков

Длительность	Без аудио	С аудио
4s	8 credits ($0.04)	14 credits ($0.07)
8s	14 credits ($0.07)	28 credits ($0.14)
12s	19 credits ($0.095)	38 credits ($0.19)

720p

720p Разрешение

Высокое качество, рекомендуется для производства

Длительность	Без аудио	С аудио
4s	14 credits ($0.07)	28 credits ($0.14)
8s	28 credits ($0.14)	56 credits ($0.28)
12s	42 credits ($0.21)	84 credits ($0.42)

API эндпоинты

POST/v1/generateСгенерировать новое видео

Создать новую задачу генерации видео с использованием модели Seedance 2.0. Поддерживает режимы текст-в-видео и изображение-в-видео.

Тело запроса

Parameter	Тип	Обязательно	Описание
`prompt`	string	Обязательно	Текстовое описание видео для генерации (макс. 2000 символов)
`aspect_ratio`	string	Необязательно	Соотношение сторон вывода. Поддерживаемые: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 (По умолчанию: 1:1)
`resolution`	string	Необязательно	Разрешение видео: "480p" или "720p" (По умолчанию: 720p)
`duration`	string	Необязательно	Длительность видео в секундах: "4", "8" или "12" (По умолчанию: 8)
`generate_audio`	boolean	Необязательно	Включить AI генерацию аудио для видео (По умолчанию: false)
`fixed_lens`	boolean	Необязательно	Зафиксировать камеру для уменьшения размытия движения (По умолчанию: false)
`image_urls`	string[]	Необязательно	Массив URL референсных изображений для генерации из изображения (макс. 1)
`callback_url`	string	Необязательно	URL вебхука для асинхронных уведомлений. Должен быть публично доступен.

Текст в видео

json

{
  "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8"
}

Изображение в видео

json

{
  "prompt": "The character slowly turns and smiles at the camera",
  "image_urls": [
    "https://example.com/my-image.jpg"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "4"
}

С генерацией аудио

json

{
  "prompt": "A peaceful river flowing through a forest with birds singing",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": "8",
  "generate_audio": true,
  "fixed_lens": true
}

Ответы

Task created successfully

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "IN_PROGRESS"
  }
}

GET/v1/statusПолучить статус задачи

Проверить статус задачи генерации видео и получить результат после завершения.

Параметры запроса

Parameter	Тип	Обязательно	Описание
`task_id`	string	Обязательно	Уникальный ID задачи, возвращенный из эндпоинта generate

Пример запроса

bash

curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
  -H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Поле response в API статуса — это массив URL видео. Вы можете напрямую обращаться к data.response[0] для получения URL видео.

javascript

// Extract video URL from response
const videoUrl = data.response[0];

Ответы

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "seed15abc123def456pro",
    "status": "SUCCESS",
    "consumed_credits": 28,
    "created_at": "2026-02-07T10:30:00Z",
    "request": {
      "prompt": "A majestic eagle soaring through golden sunset clouds",
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "duration": "8"
    },
    "response": [
      "https://cdn.example.com/videos/seed15abc123def456pro.mp4"
    ],
    "error_message": null
  }
}

Песочница API

Тестируйте API прямо в браузере. Замените YOUR_API_KEY на ваш реальный API ключ.

Песочница APIPOST

Базовый URL

Конечная точка

Заголовки

Тело запроса

Коды ошибок

Status	Code	Description
400 Неверный запрос	`INVALID_PROMPT`	Промпт недействителен или пуст
400 Неверный запрос	`INVALID_ASPECT_RATIO`	Неподдерживаемое соотношение сторон
400 Неверный запрос	`INVALID_RESOLUTION`	Разрешение должно быть 480p или 720p
400 Неверный запрос	`INVALID_DURATION`	Длительность должна быть 4, 8 или 12 секунд
400 Неверный запрос	`TOO_MANY_IMAGES`	Максимум 1 URL изображения в массиве image_urls
401 Не авторизован	`INVALID_API_KEY`	API ключ отсутствует или недействителен
402	`INSUFFICIENT_CREDITS`	Недостаточно кредитов для этой операции
404 Не найдено	`TASK_NOT_FOUND`	ID задачи не найден или не принадлежит вашему аккаунту
500 Внутренняя ошибка сервера	`INTERNAL_ERROR`	Ошибка сервера, пожалуйста, попробуйте позже