label llms.txt open_chatgpt

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

Генерируйте видео Seedance 2.5 и Seedance 2.5 Flash через API v3: текст в видео, референсные изображения, видео и аудио, первый и последний кадры, редактирование видео и вывод в 4K.

API v3 · 2.5 / 2.5 Flash Base URL: https://seedanceapi.org/v3

API v3 — отдельный эндпоинт только для Seedance 2.5. Существующие интеграции на /v1 и /v2 продолжают работать как раньше; переключайтесь на /v3, только когда нужен Seedance 2.5.

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

bash
1curl -X POST 'https://seedanceapi.org/v3/generate' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "model": "seedance-2.5",
6 "prompt": "A cinematic aerial shot over a coastline at golden hour",
7 "aspect_ratio": "16:9",
8 "resolution": "720p",
9 "duration": 10
10 }'

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

Все запросы к API требуют Bearer-токен в заголовке Authorization.

Важно: Получите API-ключ на странице API Keys в личном кабинете. Храните его на сервере и никогда не включайте в код браузера. → Получить API-ключ

http
1Authorization: Bearer YOUR_API_KEY

Режимы генерации

РежимПоля для отправки
Текст в видеоprompt + aspect_ratio
Генерация по референсам (изображения, видео, аудио)prompt + image_urls / reference_video_urls / reference_audio_urls
Первый / последний кадрprompt + first_frame_url (+ last_frame_url)
Редактирование видеоprompt + reference_video_urls (1) + duration: -1 + aspect_ratio: "adaptive"

Цены (кредиты)

Кредиты списываются за каждую секунду видео и зависят от модели, разрешения и наличия референсных видео. Сумма списывается при создании задачи и автоматически возвращается в случае сбоя.

Нужно пополнить кредиты? → Пополнить на странице цен. 1 USD = 100 кредитов.

2.5

Seedance 2.5

Максимальное качество, поддерживает 480p, 720p и нативный 4K.

РазрешениеВходСтавкаПример
480pТекст / изображения / аудио28 кредитов / с10 с вывода = 280 кредитов
480pС референсным видео17 кредитов / с5 с референса + 10 с вывода = 255 кредитов
720pТекст / изображения / аудио63 кредитов / с10 с вывода = 630 кредитов
720pС референсным видео38 кредитов / с5 с референса + 10 с вывода = 570 кредитов
4kТекст / изображения / аудио251 кредитов / с10 с вывода = 2510 кредитов
4kС референсным видео155 кредитов / с5 с референса + 10 с вывода = 2325 кредитов
Flash

Seedance 2.5 Flash

Быстрее и дешевле, поддерживает 480p и 720p.

РазрешениеВходСтавкаПример
480pТекст / изображения / аудио18.5 кредитов / с10 с вывода = 185 кредитов
480pС референсным видео11.5 кредитов / с5 с референса + 10 с вывода = 173 кредитов
720pТекст / изображения / аудио41 кредитов / с10 с вывода = 410 кредитов
720pС референсным видео25.5 кредитов / с5 с референса + 10 с вывода = 383 кредитов

При передаче reference_video_urls секунды референсного видео тарифицируются по более низкой ставке входного видео, плюс секунды вывода. Редактирование видео (duration -1) тарифицируется как двойная длина входного видео. Итог округляется вверх до целого кредита.

Эндпоинты API

POST/v3/generate

Запустить задачу Seedance 2.5 или Seedance 2.5 Flash. Вызов сразу возвращает task_id; опрашивайте /v3/status или передайте callback_url, чтобы получить результат.

Тело запроса

Body ParametersJSON
prompt:string

Текстовый промпт (обязателен, до 5000 символов).

model:optional string

seedance-2.5 (по умолчанию) или seedance-2.5-flash. Defaults to seedance-2.5.

duration:optional number

Длительность вывода в секундах: любое целое число от 4 до 30. Для редактирования видео передайте -1 — вывод сохранит длину входного видео. Defaults to 5.

resolution:optional string

Seedance 2.5: 480p, 720p или 4k. Seedance 2.5 Flash: 480p или 720p. 1080p недоступно. Defaults to 720p.

aspect_ratio:optional string

16:9, 9:16, 4:3, 3:4 или adaptive. Для редактирования видео обязателен adaptive. Defaults to 16:9.

image_urls:optional string[]

До 4 URL референсных изображений (http/https). Опишите в промпте, как использовать каждое изображение.

first_frame_url:optional string

URL изображения, используемого как первый кадр. Не сочетается с image_urls, reference_video_urls или reference_audio_urls.

last_frame_url:optional string

Необязательный URL изображения для последнего кадра. Требует first_frame_url.

reference_video_urls:optional string[]

До 3 URL референсных видео, суммарно до 30 секунд. Для редактирования видео отправьте ровно одно видео длиной от 4 до 30 секунд.

reference_audio_urls:optional string[]

До 3 URL референсного аудио, например музыки или голосовой дорожки.

generate_audio:optional boolean

Сгенерировать звуковую дорожку вместе с видео. Defaults to true.

web_search:optional boolean

Позволить модели искать в интернете информацию о субъектах из промпта. Defaults to false.

callback_url:optional string

Необязательный вебхук, вызываемый по завершении задачи (публичный URL; localhost не разрешён).

public:optional boolean

Необязательно: разрешить показ результата в публичной галерее.

Текст в видео

json
1{
2 "model": "seedance-2.5",
3 "prompt": "A slow dolly shot through a neon-lit street in the rain",
4 "aspect_ratio": "16:9",
5 "resolution": "720p",
6 "duration": 10
7}

Референсное изображение + аудио

json
1{
2 "model": "seedance-2.5",
3 "prompt": "The woman in the reference image dances to the beat of the reference audio in a sunlit studio",
4 "image_urls": ["https://example.com/character.jpg"],
5 "reference_audio_urls": ["https://example.com/beat.mp3"],
6 "aspect_ratio": "9:16",
7 "resolution": "720p",
8 "duration": 8
9}

Первый и последний кадр (Flash)

json
1{
2 "model": "seedance-2.5-flash",
3 "prompt": "The flower bud slowly opens into full bloom",
4 "first_frame_url": "https://example.com/bud.jpg",
5 "last_frame_url": "https://example.com/bloom.jpg",
6 "resolution": "480p",
7 "duration": 6
8}

Редактирование видео

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Change the season to winter with falling snow; keep the camera motion",
4 "reference_video_urls": ["https://example.com/input-12s.mp4"],
5 "aspect_ratio": "adaptive",
6 "duration": -1,
7 "resolution": "720p"
8}

Вывод 4K

json
1{
2 "model": "seedance-2.5",
3 "prompt": "Macro shot of morning dew rolling off a green leaf",
4 "aspect_ratio": "16:9",
5 "resolution": "4k",
6 "duration": 5
7}

Ответы

Task created

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "IN_PROGRESS",
7 "consumed_credits": 630
8 }
9}
GET/v3/status

Опрашивайте по task_id, пока status не станет SUCCESS или FAILED. Здесь возвращаются только задачи, созданные через /v3/generate.

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

Body ParametersJSON
task_id:string

Идентификатор задачи, возвращаемый POST /v3/generate (заканчивается на sd25).

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

bash
1curl -X GET 'https://seedanceapi.org/v3/status?task_id=n90a1b2c3d4e5f6sd25' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

Tip: Когда status равен SUCCESS, data.response — это массив URL видео; используйте data.response[0] для первого URL. Скачайте и сохраните файл, если он нужен надолго.

javascript
1const videoUrl = data.response[0];

Ответы

1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "task_id": "n90a1b2c3d4e5f6sd25",
6 "status": "SUCCESS",
7 "consumed_credits": 630,
8 "created_at": "2026-11-19T10:30:00Z",
9 "type": "seedance-2.5-t2v",
10 "request": {
11 "model": "seedance-2.5",
12 "prompt": "A slow dolly shot…",
13 "aspect_ratio": "16:9",
14 "duration": 10
15 },
16 "response": [
17 "https://cdn.example.com/videos/n90a1b2c3d4e5f6sd25.mp4"
18 ],
19 "error_message": null
20 }
21}

Песочница API

Попробуйте API в браузере. Замените YOUR_API_KEY на свой настоящий ключ. Каждый успешный вызов тарифицируется.

Песочница APIPOST

Коды ошибок

StatusКогда возникает
400 Неверный запросПараметр отсутствует или недействителен, например неподдерживаемые model, resolution, aspect_ratio, duration или URL медиа. В сообщении указано, какой именно.
401 Не авторизованAPI-ключ отсутствует или недействителен.
402 Недостаточно кредитов для этой задачи.
404 Не найденоЗадача не существует или была создана не через /v3/generate.
500 Внутренняя ошибка сервераОшибка сервера. Повторите попытку позже; за неудачные задачи средства возвращаются автоматически.