Rivya AI Docs
Сторінки API моделей

API-інтеграція для Seedance 1.5 Pro

Використовуйте Seedance 1.5 Pro через Rivya Public API v1 з ID моделі seedance-1-5-pro, підтримуваними входами, параметрами, правилами Files API, кредитами й прикладами відповідей.

Доступно через APIТекст або URL готові; референсні режими використовують Files APIВідео
ID моделі API

seedance-1-5-pro

Входи

text, file

Files API

Потрібно для референсних режимів

Базові кредити

28

Можливість

Відео

Білінг

FIXED

Ліміт промпта

2500 символів

Контракт запиту

Надсилайте ID моделі на верхньому рівні. Керування конкретної моделі належить у params.

КлючТипОбов'язковоЗа замовчуваннямОпис
modelstringТакseedance-1-5-proВикористовуйте seedance-1-5-pro як ID моделі API.
promptstringТак-Максимум 2500 символів для цієї моделі.
paramsobjectНі-Об'єкт параметрів конкретної моделі. Дозволені ключі дивіться в рядках нижче.
client_request_idstringНі-Необов'язковий клієнтський ID для трасування запитів у вашій системі.

Параметри моделі

КлючТипОбов'язковоЗа замовчуваннямДіапазонОпціїОпис
resolutionselectНі720p-480p, 720p, 1080pРоздільна здатність
durationselectНі8-4, 8, 12Тривалість
generate_audioselectНіfalse-false, trueГенерувати аудіо
aspectRatioselectНі1:1-1:1, 4:3, 3:4, 16:9, 9:16, 21:9Співвідношення сторін
fixed_lensselectНіfalse-false, trueКерує тим, чи має кадр поводитися ближче до фіксованої камери. Увімкнення стримує рух камери; вимкнення дозволяє помітніший рух.

Політика завантаження

Спочатку завантажте референсні файли, потім розмістіть повернений URL і токен тривалості всередині params.referenceMediaItems.

Правило референсів

Референсне зображення: Завантажте до 2 файлів зображень для проєктів із зображеннями.

Максимум файлів

2

Прийняті типи файлів

image

Токен тривалості

Відео- й аудіореференси мають містити durationToken з /api/v1/files, коли потрібна перевірка тривалості.

kindМаксимальний розмірMIME types
image10 MBimage/jpeg, image/png, image/webp

Мінімальний запит

{
  "model": "seedance-1-5-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false"
  }
}

Запит із референсним файлом

{
  "model": "seedance-1-5-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "8",
    "generate_audio": "false",
    "aspectRatio": "1:1",
    "fixed_lens": "false",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Відповідь створення

Ендпоінт створення повертає публічний ID задачі. Опитуйте ендпоінт статусу, доки задача не завершиться успішно або з помилкою.

{
  "id": "task_seedance_1_5_pro_example",
  "status": "queued",
  "model": "seedance-1-5-pro",
  "reserved_credits": 28,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Поширені помилки

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Деякі режими потребують завантаження референсів через Files API.