Dokumentacja Rivya AI
Strony API modeli

Integracja API Seedance 1.0 Pro

Używaj Seedance 1.0 Pro przez Rivya Public API v1 z identyfikatorem modelu seedance-1-0-pro, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIWideo
Identyfikator modelu API

seedance-1-0-pro

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

25

Możliwość

Wideo

Rozliczenia

FIXED

Limit promptu

10000 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

KluczTypWymaganeDomyślnieOpis
modelstringTakseedance-1-0-proUżyj seedance-1-0-pro jako identyfikatora modelu API.
promptstringTak-Maksymalnie 10000 znaków dla tego modelu.
paramsobjectNie-Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_idstringNie-Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

KluczTypWymaganeDomyślnieZakresOpcjeOpis
resolutionselectNie720p-480p, 720p, 1080pRozdzielczość
durationselectNie5-5, 10Czas trwania
aspect_ratioselectNie16:9-21:9, 16:9, 4:3, 1:1, 3:4, 9:16Proporcje obrazu
camera_fixedselectNiefalse-false, trueKontroluje, czy ujęcie ma zachowywać się bardziej jak stała kamera. Włączenie ogranicza ruch kamery; wyłączenie pozwala na bardziej widoczny ruch.
seednumberNie-1min -1 / max 2147483647-Pozostaw puste, aby za każdym razem uzyskać nowy losowy wynik. Ponowne użycie tej samej liczby całkowitej ułatwia odtworzenie albo dopracowanie poprzedniego wyniku. Wynik pozostaje bliższy tylko wtedy, gdy prompt i inne kluczowe ustawienia również pozostają podobne; nie jest to gwarantowane dopasowanie 1:1.
enable_safety_checkerselectNietrue-true, falseKontrola bezpieczeństwa

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Obraz referencyjny: Prześlij 1 plik obrazu dla przebiegów image-to-video.

Maks. plików

1

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kindMaks. rozmiarTypy MIME
image10 MBimage/jpeg, image/png, image/webp

Żądanie minimalne

{
  "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"
  }
}

Żądanie z plikiem referencyjnym

{
  "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"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "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
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.