Rivya AI Docs
Modell-API-Seiten

Infinitalk API-Integration

Nutze Infinitalk über Rivya Public API v1 mit Model-ID infinitalk, unterstützten Eingaben, Parametern, Files-API-Regeln, Credits und Response-Beispielen.

Über API verfügbarBereitschaftVideo
API-Modell-ID

infinitalk

Eingaben

file

Files API

Für Referenzmodi erforderlich

Basis-Credits

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

Fähigkeit

Video

Abrechnung

METERED

Prompt-Limit

5000 Zeichen

Request-Kontrakt

Sende die Modell-ID auf Top-Level. Modellspezifische Controls gehören in params.

KeyTypErforderlichStandardBeschreibung
modelstringJainfinitalkVerwende infinitalk als API-Modell-ID.
promptstringJa-Maximal 5000 Zeichen für dieses Modell.
paramsobjectNein-Modellspezifisches Parameterobjekt. Die erlaubten Keys stehen in den Zeilen darunter.
client_request_idstringNein-Optionale Client-ID, um Requests in deinem System nachzuverfolgen.

Modellparameter

KeyTypErforderlichStandardBereichOptionenBeschreibung
resolutionselectNein480p-480p, 720pAuflösung
seednumberNein-min 10000 / max 1000000-Lass das Feld leer, um jedes Mal ein neues zufälliges Ergebnis zu erhalten. Wenn du dieselbe Ganzzahl erneut verwendest, lässt sich ein früheres Ergebnis leichter reproduzieren oder feinabstimmen. Es bleibt nur dann näher am Original, wenn Prompt und andere wichtige Einstellungen ebenfalls ähnlich bleiben, und es ist keine garantierte 1:1-Übereinstimmung.

Upload-Richtlinie

Lade zuerst Referenzdateien hoch und setze dann die zurückgegebene URL und den durationToken in params.referenceMediaItems.

Referenzregel

Porträtbild und Audio: Lade ein Porträtbild und einen Audioclip zusammen hoch.

Max. Dateien

2

Akzeptierte Dateitypen

image, audio

Duration Token

Video- und Audioreferenzen sollten durationToken aus /api/v1/files mitführen, wenn eine Dauerprüfung erforderlich ist.

kindMax. GrößeMIME-Typen
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg

Minimalrequest

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

Request mit Referenzdatei

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

Create-Response

Der Create-Endpunkt gibt eine öffentliche Task-ID zurück. Frage den Status-Endpunkt ab, bis der Task erfolgreich ist oder fehlschlägt.

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

Häufige Fehler

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Einige Modi benötigen Referenz-Uploads über Files API.