label llms.txt open_chatgpt

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

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

API v1 · 2.0 Mini Base URL: https://seedanceapi.org/v1

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

bash
1curl -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 ключ

http
1Authorization: Bearer YOUR_API_KEY

Цены

480p

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

14,25 кредита за секунду, округление вверх за запрос

ДлительностьКредиты
4s57 credits
5s72 credits
8s114 credits
10s143 credits
12s171 credits
15s214 credits
720p

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

30,75 кредита за секунду, округление вверх за запрос

ДлительностьКредиты
4s123 credits
5s154 credits
8s246 credits
10s308 credits
12s369 credits
15s462 credits

API эндпоинты

POST/v1/generate

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

Тело запроса

Body ParametersJSON
prompt:string

Текстовое описание видео для генерации (макс. 2000 символов)

aspect_ratio:optional string

Соотношение сторон. Поддерживаемые: 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, adaptive Defaults to 1:1.

resolution:optional string

Разрешение видео: 480p или 720p Defaults to 720p.

duration:optional string

Длительность видео в секундах: целое число 4–15 Defaults to 8.

generate_audio:optional boolean

Включить AI генерацию аудио (не влияет на цену) Defaults to false.

fixed_lens:optional boolean

Устарело — принимается для совместимости, игнорируется Seedance 2.0 Mini Defaults to false.

image_urls:optional string[]

Массив URL референсных изображений для генерации из изображения (макс. 1)

callback_url:optional string

URL вебхука для асинхронных уведомлений. Должен быть публично доступен.

Текст в видео

json
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}

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

json
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}

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

json
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}
GET/v1/status

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

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

Body ParametersJSON
task_id:string

Уникальный ID задачи, возвращенный из эндпоинта generate

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

bash
1curl -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 видео.

javascript
1// Extract video URL from response
2const 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 ключ.

Песочница APIPOST

Коды ошибок

StatusCodeDescription
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_KEYAPI ключ отсутствует или недействителен
402 INSUFFICIENT_CREDITSНедостаточно кредитов для этой операции
404 Не найденоTASK_NOT_FOUNDID задачи не найден или не принадлежит вашему аккаунту
500 Внутренняя ошибка сервераINTERNAL_ERRORОшибка сервера, пожалуйста, попробуйте позже