switch_heading
Документация API Seedance 2.5
Генерируйте видео Seedance 2.5 и Seedance 2.5 Flash через API v3: текст в видео, референсные изображения, видео и аудио, первый и последний кадры, редактирование видео и вывод в 4K.
API v3 — отдельный эндпоинт только для Seedance 2.5. Существующие интеграции на /v1 и /v2 продолжают работать как раньше; переключайтесь на /v3, только когда нужен Seedance 2.5.
Быстрый старт
| 1 | curl -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-ключ
| 1 | Authorization: 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 кредитов.
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 кредитов |
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
/v3/generateЗапустить задачу Seedance 2.5 или Seedance 2.5 Flash. Вызов сразу возвращает task_id; опрашивайте /v3/status или передайте callback_url, чтобы получить результат.
Тело запроса
Текстовый промпт (обязателен, до 5000 символов).
seedance-2.5 (по умолчанию) или seedance-2.5-flash. Defaults to seedance-2.5.
Длительность вывода в секундах: любое целое число от 4 до 30. Для редактирования видео передайте -1 — вывод сохранит длину входного видео. Defaults to 5.
Seedance 2.5: 480p, 720p или 4k. Seedance 2.5 Flash: 480p или 720p. 1080p недоступно. Defaults to 720p.
16:9, 9:16, 4:3, 3:4 или adaptive. Для редактирования видео обязателен adaptive. Defaults to 16:9.
До 4 URL референсных изображений (http/https). Опишите в промпте, как использовать каждое изображение.
URL изображения, используемого как первый кадр. Не сочетается с image_urls, reference_video_urls или reference_audio_urls.
Необязательный URL изображения для последнего кадра. Требует first_frame_url.
До 3 URL референсных видео, суммарно до 30 секунд. Для редактирования видео отправьте ровно одно видео длиной от 4 до 30 секунд.
До 3 URL референсного аудио, например музыки или голосовой дорожки.
Сгенерировать звуковую дорожку вместе с видео. Defaults to true.
Позволить модели искать в интернете информацию о субъектах из промпта. Defaults to false.
Необязательный вебхук, вызываемый по завершении задачи (публичный URL; localhost не разрешён).
Необязательно: разрешить показ результата в публичной галерее.
Текст в видео
| 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 | } |
Референсное изображение + аудио
| 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)
| 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 | } |
Редактирование видео
| 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
| 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 | } |
/v3/statusОпрашивайте по task_id, пока status не станет SUCCESS или FAILED. Здесь возвращаются только задачи, созданные через /v3/generate.
Параметры запроса
Идентификатор задачи, возвращаемый POST /v3/generate (заканчивается на sd25).
Пример запроса
| 1 | curl -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. Скачайте и сохраните файл, если он нужен надолго.
| 1 | const 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 на свой настоящий ключ. Каждый успешный вызов тарифицируется.
Коды ошибок
| Status | Когда возникает |
|---|---|
| 400 Неверный запрос | Параметр отсутствует или недействителен, например неподдерживаемые model, resolution, aspect_ratio, duration или URL медиа. В сообщении указано, какой именно. |
| 401 Не авторизован | API-ключ отсутствует или недействителен. |
| 402 | Недостаточно кредитов для этой задачи. |
| 404 Не найдено | Задача не существует или была создана не через /v3/generate. |
| 500 Внутренняя ошибка сервера | Ошибка сервера. Повторите попытку позже; за неудачные задачи средства возвращаются автоматически. |