Документация Seedance 2.0 API
Полное руководство по интеграции Seedance 2.0 API генерации видео в ваши приложения.
Быстрый старт
| 1 | curl -X POST 'https://seedanceapi.org/v1/generate' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "prompt": "A cinematic shot of mountains at sunrise with flowing clouds", |
| 6 | "aspect_ratio": "16:9", |
| 7 | "resolution": "720p", |
| 8 | "duration": "8" |
| 9 | }' |
Аутентификация
Все запросы к API требуют аутентификации с использованием Bearer токена в заголовке Authorization.
Важно: Вы можете получить свой API ключ со страницы API Keys в вашей панели управления. → Получить API ключ
| 1 | Authorization: Bearer YOUR_API_KEY |
Цены
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 Разрешение
Высокое качество, рекомендуется для производства
| Длительность | Без аудио | С аудио |
|---|---|---|
| 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 эндпоинты
/v1/generateСоздать новую задачу генерации видео с использованием модели Seedance 2.0. Поддерживает режимы текст-в-видео и изображение-в-видео.
Тело запроса
Текстовое описание видео для генерации (макс. 2000 символов)
Соотношение сторон вывода. Поддерживаемые: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.
Разрешение видео: 480p или 720p Defaults to 720p.
Длительность видео в секундах: 4, 8 или 12 Defaults to 8.
Включить AI генерацию аудио для видео Defaults to false.
Зафиксировать камеру для уменьшения размытия движения Defaults to false.
Массив URL референсных изображений для генерации из изображения (макс. 1)
URL вебхука для асинхронных уведомлений. Должен быть публично доступен.
Текст в видео
| 1 | { |
| 2 | "prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves", |
| 3 | "aspect_ratio": "16:9", |
| 4 | "resolution": "720p", |
| 5 | "duration": "8" |
| 6 | } |
Изображение в видео
| 1 | { |
| 2 | "prompt": "The character slowly turns and smiles at the camera", |
| 3 | "image_urls": [ |
| 4 | "https://example.com/my-image.jpg" |
| 5 | ], |
| 6 | "aspect_ratio": "16:9", |
| 7 | "resolution": "720p", |
| 8 | "duration": "4" |
| 9 | } |
С генерацией аудио
| 1 | { |
| 2 | "prompt": "A peaceful river flowing through a forest with birds singing", |
| 3 | "aspect_ratio": "16:9", |
| 4 | "resolution": "720p", |
| 5 | "duration": "8", |
| 6 | "generate_audio": true, |
| 7 | "fixed_lens": true |
| 8 | } |
Ответы
Task created successfully
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "seed15abc123def456pro", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
/v1/statusПроверить статус задачи генерации видео и получить результат после завершения.
Параметры запроса
Уникальный ID задачи, возвращенный из эндпоинта generate
Пример запроса
| 1 | curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
💡 Tip: Поле response в API статуса — это массив URL видео. Вы можете напрямую обращаться к data.response[0] для получения URL видео.
| 1 | // Extract video URL from response |
| 2 | const videoUrl = data.response[0]; |
Ответы
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "seed15abc123def456pro", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 28, |
| 8 | "created_at": "2026-02-07T10:30:00Z", |
| 9 | "request": { |
| 10 | "prompt": "A majestic eagle soaring through golden sunset clouds", |
| 11 | "aspect_ratio": "16:9", |
| 12 | "resolution": "720p", |
| 13 | "duration": "8" |
| 14 | }, |
| 15 | "response": [ |
| 16 | "https://cdn.example.com/videos/seed15abc123def456pro.mp4" |
| 17 | ], |
| 18 | "error_message": null |
| 19 | } |
| 20 | } |
Песочница API
Тестируйте API прямо в браузере. Замените YOUR_API_KEY на ваш реальный API ключ.
Коды ошибок
| 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 | Ошибка сервера, пожалуйста, попробуйте позже |