Seedance 2.5 API: как вызвать, параметры, лимиты и стоимость в кредитах

Коротко: Seedance 2.5 можно вызывать через API Yovid с одним ключом. Отправьте POST https://yovid.ai/v1/videos/generations с "model": "seedance-2.5" и промптом, затем опрашивайте GET /v1/tasks/{task_id}, пока статус не станет completed, и прочитайте output.video_url. Ролики длятся от 4 до 30 секунд, а один запрос может передать до 30 изображений, 10 видео и 10 аудиофайлов в качестве референсов. Оплата идёт теми же кредитами Yovid, что и на сайте, причём кредиты списываются только при успешном выполнении задачи.

Содержание

1. Откуда берётся доступ к API Seedance 2.5
2. Быстрый старт за четыре шага
3. Параметры запроса
4. Как API выбирает режим генерации
5. Лимиты референсов и медиа
6. Сколько стоит запрос
7. Ошибки, повторы и лимиты запросов
8. Полный пример на Python
9. Вопросы и ответы

Откуда берётся доступ к API Seedance 2.5

Seedance 2.5 — модель ByteDance Seed. Собственный путь ByteDance для разработчиков проходит через её облачные платформы: в анонсе от 31 июля 2026 года говорилось, что доступ к API появится через BytePlus ModelArk, по сообщениям прессы, Volcano Engine открыла доступ к API в Китае 7 августа, а страница Seedance 2.5 от ByteDance ведёт в плейграунд BytePlus.

Yovid — независимая платформа, не связанная с ByteDance, и предлагает Seedance 2.5 через собственный API:

• Один ключ — один счёт. Один и тот же ключ и одни и те же кредиты подходят для Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro и 1.0 Pro Fast.
• Стабильные публичные ID. Вы отправляете seedance-2.5, а названия моделей у провайдеров Yovid держит у себя, поэтому они могут меняться, не ломая ваш код.
• Тот же аккаунт, что и на сайте. Ролики, созданные через API, используют уже имеющиеся у вас тариф и кредиты.

Полный справочник — в документации API Yovid; этот гид посвящён тому, что относится именно к Seedance 2.5.

Быстрый старт за четыре шага

1. Создайте ключ API

Откройте Настройки → Ключи API, задайте название ключа и создайте его. Полный секретный ключ показывается только один раз, поэтому сохраните его в менеджере секретов и загружайте на сервере как YOVID_API_KEY. Никогда не размещайте его в коде браузера или мобильного приложения.

2. Создайте задачу

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Опрашивайте задачу

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Опрашивайте задачу каждые 5–10 секунд, пока статус pending или processing, постепенно увеличивая интервал. Когда статус сменится на completed, URL видео будет в output.video_url; если он сменится на failed, прекратите опрос и прочитайте error.

4. Проверьте баланс кредитов

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available — кредиты, которые может использовать новая задача; reserved — кредиты, удержанные для задач, которые ещё выполняются.

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

API ещё до создания задачи проверяет каждое значение на соответствие модели и вашему тарифу и, если что-то не разрешено, возвращает 403 или 422 с проблемным полем в param. Если начать с кадра, результат повторит пропорции этого изображения.

Как API выбирает режим генерации

Режим провайдера вы никогда не передаёте. Yovid выбирает его по прикреплённым медиа:

В режиме референсов обращайтесь к файлам в промпте по их порядку в каждом массиве: @image1, @image2, @video1, @audio1. Запрос с референсами выглядит так:

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

Аудиореференсы — функция API: редактор на сайте принимает изображения и видео, а API добавляет до 10 аудиофайлов для голоса, трека или ритма.

Лимиты референсов и медиа

По данным страницы о моделях и входных данных в документации API:

Все медиа должны быть доступны по публичным HTTPS-URL. Yovid отклоняет localhost, адреса частных сетей, URL со встроенными учётными данными и имена хостов, которые не удаётся разрешить. Используйте URL, а не Base64: провайдер ограничивает тело каждого запроса 64 МБ.

Сколько стоит запрос

API списывает те же кредиты, что и сайт, по тем же ставкам. По базовой ставке пакетов кредитов Seedance 2.5 стоит около 3 кредитов в секунду в 480p и около 6,1 в 720p, так что 10-секундный ролик в 720p обходится примерно в 61 кредит, а 30-секундный — примерно в 183. У подписчиков секунда стоит дешевле.

• Референсные видео оплачиваются за длину референсного ролика плюс длину результата, по более низкой ставке: около 2,1 кредита в секунду в 480p и 4,6 в 720p.
• Отключение content_filter умножает стоимость на 1,1.
• Сначала резерв, потом списание. Кредиты резервируются при создании задачи и списываются, только если она завершится; если задача не удалась, они возвращаются.
• Доступ по тарифу. Для Seedance 2.5 нужен платный тариф или разовый пакет кредитов. Бесплатный аккаунт получит 403 plan_upgrade_required.

Завершённая задача сообщает, сколько кредитов израсходовано, в поле credits_used. Тарифы и пакеты — на странице цен, а самый дешёвый способ начать описан в статье о том, можно ли пользоваться Seedance 2.5 бесплатно.

Ошибки, повторы и лимиты запросов

Каждый ключ допускает до 120 запросов в минуту, и опрос тоже учитывается. Эндпоинт создания задач пока не поддерживает ключи идемпотентности, поэтому не повторяйте POST автоматически, если не знаете, прошёл ли первый запрос: так можно создать вторую задачу и зарезервировать кредиты дважды. Сохраняйте каждый полученный task_id.

Полный пример на Python

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

В промпте используются таймкоды — самый надёжный способ заполнить 30-секундный ролик. В гиде по промптам Seedance 2.5 собрано 13 промптов, которые можно отправлять как есть, а сравнения с Kling 3.0, Veo 3.1 и Seedance 2.0 помогут выбрать, какой ID модели вызывать.

Вопросы и ответы

Есть ли официальный API Seedance 2.5?

ByteDance предоставляет Seedance 2.5 разработчикам через свои облачные платформы Volcano Engine и BytePlus. API Yovid — независимая альтернатива: один ключ и один баланс кредитов для Seedance 2.5 и других моделей Seedance.

Какой ID у модели Seedance 2.5 в Yovid?

seedance-2.5. Другие публичные ID: seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro и seedance-1.0-pro-fast.

Какой длины может быть видео через API Seedance 2.5?

От 4 до 30 секунд на задачу, длина задаётся параметром duration.

Какие разрешения поддерживает API Seedance 2.5?

В документации API для seedance-2.5 указаны 480p и 720p. Потолок задаёт и ваш тариф: если запрошенное качество выше него, API вернёт 403 ещё до создания задачи.

Можно ли отправить аудио как референс?

Да, до 10 файлов MP3 или WAV в audio_urls; в промпте к ним обращаются как @audio1, @audio2 и так далее. Аудиореференсы доступны только через API.

Списываются ли кредиты за неудачную задачу?

Нет. Кредиты резервируются при создании задачи и списываются, только когда она успешно завершается.

Сколько запросов можно отправлять?

До 120 запросов в минуту на ключ, включая опрос, плюс лимит одновременных задач, который зависит от тарифа. Ответ 429 означает, что нужно подождать и повторить запрос с увеличением интервала.

Готовы начать разработку? Создайте ключ в разделе Настройки → Ключи API и следуйте быстрому старту API.