Seedance 2.0 / Fast

Seedance — модель от ByteDance с самой нестандартной схемой биллинга в каталоге: оплата идёт по фактическим completion-токенам, которые становятся известны только после завершения генерации.

Доступно через byteplus (без fallback — это эксклюзивный провайдер).

Варианты

model_name	Описание
seedance-2.0	Полная модель, поддерживает 480p, 720p, 1080p
seedance-2.0-fast	Быстрая, дешевле, до 720p

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

Поле	Тип	Обяз.	Описание
model_name	string	да	seedance-2.0 или seedance-2.0-fast
prompt	string	да	Текст
duration	int	да	Длительность, секунды. 5-10
resolution	string	да	480p, 720p, 1080p (1080p только для seedance-2.0)
aspect_ratio	string	нет	16:9, 9:16, 1:1, 4:3, 3:4, 21:9
video_urls	array	нет	Список URL reference-видео (image-to-video / video extend)
image_url	string	нет	URL стартового кадра
webhook_url	string	нет	URL для callback’а

Особенности биллинга

См. Билллинг → По токенам — кратко:

1. При создании задачи мы оцениваем worst-case по формуле (input_duration + output_duration) × W × H × FPS / 1024, где W/H зависит от resolution и aspect_ratio.
2. Hold = worst-case в рублях.
3. После завершения провайдер возвращает фактические completion_tokens.
4. Реальная стоимость пересчитывается, переплата возвращается на ключ.

Стоимость зависит от наличия reference

Если передал video_urls — base стоимость выше: добавляется input_duration (до 15 секунд). Без reference — только output_duration учитывается.

Пример: чистый text-to-video

curl -X POST https://nexusapi.dev/generate \
  -H "Authorization: Bearer $NEXUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "model_name": "seedance-2.0-fast",
      "prompt": "Японский сад, ветер качает ветки, утро",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9"
    }
  }'

Worst-case для 5с × 720p (1280×720) × 24 FPS / 1024 ≈ ~108 тыс токенов. Конкретный hold в рублях зависит от текущей цены ByteDance — увидишь в panel.nexusapi.dev после создания задачи.

Пример: с reference-видео

{
  "params": {
    "model_name": "seedance-2.0",
    "prompt": "Продолжи в том же стиле",
    "video_urls": ["https://your-bucket.../reference.mp4"],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }
}

Reference-видео обрезается провайдером максимум до 15 секунд (SEEDANCE_MAX_INPUT_VIDEO_DURATION).

Структура result

{
  "video_url": "https://nexusapi-s3.../result.mp4",
  "duration": 5,
  "completion_tokens": 96000
}

Поле completion_tokens — для аудита, по нему пересчиталась стоимость.