switch_heading
Документация Seedance 2.0 Mini API
Полное руководство по интеграции Seedance 2.0 Mini 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 Разрешение
14,25 кредита за секунду, округление вверх за запрос
| Длительность | Кредиты |
|---|---|
| 4s | 57 credits |
| 5s | 72 credits |
| 8s | 114 credits |
| 10s | 143 credits |
| 12s | 171 credits |
| 15s | 214 credits |
720p Разрешение
30,75 кредита за секунду, округление вверх за запрос
| Длительность | Кредиты |
|---|---|
| 4s | 123 credits |
| 5s | 154 credits |
| 8s | 246 credits |
| 10s | 308 credits |
| 12s | 369 credits |
| 15s | 462 credits |
API эндпоинты
/v1/generateСоздать новую задачу генерации видео с использованием модели Seedance 2.0 Mini. Поддерживает режимы текст-в-видео и изображение-в-видео.
Тело запроса
Текстовое описание видео для генерации (макс. 2000 символов)
Соотношение сторон. Поддерживаемые: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.
Разрешение видео: 480p или 720p Defaults to 720p.
Длительность видео в секундах: целое число 4–15 Defaults to 8.
Включить AI генерацию аудио (не влияет на цену) Defaults to false.
Устарело — принимается для совместимости, игнорируется Seedance 2.0 Mini 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 | } |
Ответы
Task created successfully
| 1 | { |
| 2 | "code": 200, |
| 3 | "message": "success", |
| 4 | "data": { |
| 5 | "task_id": "n90abc123def456_seedance", |
| 6 | "status": "IN_PROGRESS" |
| 7 | } |
| 8 | } |
/v1/statusПроверить статус задачи генерации видео и получить результат после завершения.
Параметры запроса
Уникальный ID задачи, возвращенный из эндпоинта generate
Пример запроса
| 1 | curl -X GET 'https://seedanceapi.org/v1/status?task_id=n90abc123def456_seedance' \ |
| 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": "n90abc123def456_seedance", |
| 6 | "status": "SUCCESS", |
| 7 | "consumed_credits": 246, |
| 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/n90abc123def456_seedance.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 | Ошибка сервера, пожалуйста, попробуйте позже |