Dokumentacja Rivya AI
Strony API modeli

Integracja API Infinitalk

Używaj Infinitalk przez Rivya Public API v1 z identyfikatorem modelu infinitalk, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIGotowośćWideo
Identyfikator modelu API

infinitalk

Wejścia

file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_input_second · 480p=3 · 720p=12 · ⌈total⌉

Możliwość

Wideo

Rozliczenia

METERED

Limit promptu

5000 znaków

Kontrakt żądania

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

KluczTypWymaganeDomyślnieOpis
modelstringTakinfinitalkUżyj infinitalk jako identyfikatora modelu API.
promptstringTak-Maksymalnie 5000 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
resolutionselectNie480p-480p, 720pRozdzielczość
seednumberNie-min 10000 / max 1000000-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.

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 portretowy i audio: Prześlij razem jeden obraz portretowy i jeden klip audio.

Maks. plików

2

Akceptowane rodzaje plików

image, audio

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
audio10 MBaudio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg

Żądanie minimalne

{
  "model": "infinitalk",
  "params": {
    "resolution": "480p",
    "seed": 10000
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "infinitalk",
  "params": {
    "resolution": "480p",
    "seed": 10000,
    "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ę powodzeniem albo błędem.

{
  "id": "task_infinitalk_example",
  "status": "queued",
  "model": "infinitalk",
  "reserved_credits": 3,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "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.