switch_heading

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

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

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

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

bash

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

http

1	Authorization: Bearer YOUR_API_KEY

Цены

480p

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

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

Длительность	Без аудио	С аудио
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

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

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

Длительность	Без аудио	С аудио
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

API эндпоинты

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

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

Тело запроса

Body ParametersJSON

prompt:string

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

aspect_ratio:optional string

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

resolution:optional string

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

duration:optional string

Длительность видео в секундах: 4, 8 или 12 Defaults to 8.

generate_audio:optional boolean

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

fixed_lens:optional boolean

Зафиксировать камеру для уменьшения размытия движения 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	"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	}

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

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

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

Body ParametersJSON

task_id:string

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

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

bash

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

javascript

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 ключ.

Песочница 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`	Ошибка сервера, пожалуйста, попробуйте позже

switch_heading