Seedance API: модели, цены и подключение

Доступные модели Seedance

В каталоге семь идентификаторов Seedance. Похожие названия не означают одинаковую схему: например, у Seedance 2.5 — 480p/720p, а у Seedance 2.5 Eco — 720p/1080p. Не переносите разрешение или набор референсов между моделями без проверки.

Публичные тарифы Seedance API

Базовая ставка — значение priceRub публичного каталога с единицей sec. Это не обещание одинаковой цены при любых разрешениях и референсах. Перед платным запуском проверьте тариф и условия аккаунта.

Для моделей с pricingOptions ниже приведены отдельные опубликованные ставки. Для остальных каталог не публикует разбивку по разрешениям: дополнительные цены здесь не рассчитаны.

Ставка с видеореференсом сама по себе не определяет полную сумму: длительность входного видео и правило оплачиваемых секунд зависят от model_name. Не сравнивайте итоговые суммы только по колонке ₽/с.

Актуальный каталог и ставки · Цены NexusAPI

Как выбрать входные материалы

Для генерации по тексту передайте prompt без файлов. Для первого кадра используйте start_image_url; в линейке 2.0 конечный end_image_url добавляется только вместе с первым. У 2.5 и 2.5 Eco нужны оба кадра.

Для изображений-референсов используйте image_urls. В линейке 2.0 этот массив несовместим с парой start_image_url/end_image_url. В таблице выше указаны лимиты конкретной схемы.

Для 2.0 видеореференсы ограничены тремя ссылками: по 2–15 секунд, суммарно до 15 секунд. У 2.5 и 2.5 Eco — до десяти видео по 2–30 секунд, суммарно до 30 секунд; до 128 MiB на файл и 512 MiB суммарно. URL должен возвращать доступный серверу медиафайл, а не страницу просмотра.

Первый запрос Seedance API

Получите ключ в панели NexusAPI и храните его в NEXUS_API_KEY на сервере. POST /generate создаёт платную задачу и возвращает task_id. Пример ниже использует Seedance 2.0 Fast с допустимым resolution: 720p.

Сохраните task_id. При queued, pending или processing повторяйте только GET /tasks/{task_id} с паузой; completed содержит результат, failed — ошибку. Таймаут HTTP-клиента сам по себе не означает, что задача не создана.

cURL · Seedance 2.0 Fast

curl https://nexusapi.dev/generate \
  -H "Authorization: Bearer $NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params":{"model_name":"seedance-2.0-fast","prompt":"A slow camera move around a glass vase in daylight","duration":5,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}}'

Python · создание и одна проверка статуса

import os
import requests

headers = {"Authorization": "Bearer " + os.environ["NEXUS_API_KEY"]}
created = requests.post(
    "https://nexusapi.dev/generate",
    headers=headers,
    json={"params": {
        "model_name": "seedance-2.0-fast",
        "prompt": "A slow camera move around a glass vase in daylight",
        "duration": 5,
        "resolution": "720p",
        "aspect_ratio": "16:9",
        "generate_audio": True
    }},
    timeout=60,
)
created.raise_for_status()
task_id = created.json()["task_id"]
print("task_id:", task_id)

result = requests.get(
    f"https://nexusapi.dev/tasks/{task_id}",
    headers=headers,
    timeout=30,
)
result.raise_for_status()
print(result.json())

Node.js · Seedance 2.5

const response = await fetch("https://nexusapi.dev/generate", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.NEXUS_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({params: {
    model_name: "seedance-2.5",
    prompt: "A slow camera move around a glass vase in daylight",
    duration: 5,
    resolution: "480p",
    aspect_ratio: "16:9"
  }})
});
if (!response.ok) throw new Error(await response.text());
const {task_id} = await response.json();
console.log({task_id}); // Save task_id; check GET /tasks/{task_id}.

Seedance через MCP

Локальный NexusAPI MCP-сервер предоставляет инструменты чтения каталога, получения схемы, запуска генерации и проверки задачи. Клиент сначала получает схему выбранного model_name; перед платным запуском показывает параметры и запрашивает подтверждение.

MCP использует те же модели и тарифы. Наличие имени в старом списке клиента не заменяет проверку текущего каталога.

Подключение MCP и четыре инструмента

Ошибки без повторного списания

При 422 проверьте точный model_name, диапазон duration и разрешение из таблицы. Seedance 2.0 Fast и Mini не принимают 1080p; у Seedance 2.5 нет 1080p, у 2.5 Eco нет 480p. Для сценария с двумя кадрами проверьте обязательную пару полей.

Если задача уже получила task_id, сначала прочитайте её status и error. Не повторяйте POST автоматически после таймаута или ошибки получения результата. При обращении в поддержку передайте model_name, task_id и текст ошибки без API-ключа.

Поддержка NexusAPI

Подготовка сцены

Опишите главный объект, одно действие, окружение, камеру, свет и звук. При повторе меняйте один элемент сценария: так легче оценить влияние правки.

В готовом видео проверьте внешний вид объекта, движение, руки, текст, звук и края кадра. Для повторяемости сохраните prompt, параметры, входные файлы и task_id.

Seedance 2.5: промпты и реальные примеры · Seedance 2.5 API: подробные параметры и расчёт

Калькулятор Seedance 2.5

Расчёт относится только к seedance-2.5 и опубликованным тарифам 480p/720p. Он не списывает средства. Для других моделей используйте их ставки и условия; формулу 2.5 нельзя автоматически переносить на 2.0.

Без video_urls: duration × ставка разрешения. С video_urls: max(duration + ceil(R), ceil(5 × duration / 3)) × ставка разрешения; R — суммарная длительность входных видео.

• 5 с результата, без video_urls, 480p: 5 оплачиваемых секунд × 18,7 ₽ = 93,5 ₽.
• 5 с результата + 5 с видеореференса, 480p: 10 оплачиваемых секунд × 8,3 ₽ = 83 ₽.
• 8 с результата + 2 с видеореференса, 720p: 14 оплачиваемых секунд × 17 ₽ = 238 ₽.

Итог показан до округления биллингом и индивидуальных условий аккаунта. Фото- и аудиореференсы не добавляют оплачиваемые секунды.

Подробные условия Seedance 2.5

Частые вопросы

Почему у одной модели несколько ставок?

Каталог публикует pricingOptions для отдельных разрешений и режимов с видеореференсом. Цена за секунду и число оплачиваемых секунд — разные части расчёта.

Нужен ли отдельный ключ для Seedance 2.5?

Используется общий ключ NexusAPI. Модель выбирается через model_name, а допустимые поля — по её OpenAPI-схеме.

Можно ли отправить параметры 2.0 в 2.5 Eco?

Сначала проверьте схему: у этих моделей разные разрешения, лимиты референсов и требования к первому/последнему кадру. Одинаковое имя поля не гарантирует одинаковые ограничения.