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

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

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

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

seedance-1-0-pro

Входи

text, file

Files API

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

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

25

Можливість

Відео

Білінг

FIXED

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

10000 символів

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

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

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

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

КлючТипОбов'язковоЗа замовчуваннямДіапазонОпціїОпис
resolutionselectНі720p-480p, 720p, 1080pРоздільна здатність
durationselectНі5-5, 10Тривалість
aspect_ratioselectНі16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16Співвідношення сторін
camera_fixedselectНіfalse-false, trueКерує тим, чи має кадр поводитися ближче до фіксованої камери. Увімкнення стримує рух камери; вимкнення дозволяє помітніший рух.
seednumberНі-1min -1 / max 2147483647-Залиште порожнім, щоб щоразу отримувати новий випадковий результат. Повторне використання того самого цілого числа допомагає легше відтворити або тонко налаштувати попередній результат. Він лишається ближчим лише тоді, коли промпт та інші ключові налаштування теж подібні, і це не гарантує збіг 1:1.
enable_safety_checkerselectНіtrue-true, falseПеревірка безпеки

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

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

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

Референсне зображення: Завантажте 1 файл зображення для запусків із зображення у відео.

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

1

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

image

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

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

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

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

{
  "model": "seedance-1-0-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true"
  }
}

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

{
  "model": "seedance-1-0-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": "5",
    "aspect_ratio": "16:9",
    "camera_fixed": "false",
    "seed": -1,
    "enable_safety_checker": "true",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

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

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

{
  "id": "task_seedance_1_0_pro_example",
  "status": "queued",
  "model": "seedance-1-0-pro",
  "reserved_credits": 25,
  "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.