Documentazione Rivya AI
Pagine API per modello

Integrazione API di Infinitalk

Usa Infinitalk tramite Rivya Public API v1 con model id infinitalk, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APIStato di disponibilitàVideo
ID modello API

infinitalk

Input

file

Files API

Richiesto per le modalità con riferimento

Crediti base

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

Capacità

Video

Fatturazione

METERED

Limite prompt

5000 caratteri

Contratto della richiesta

Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.

KeyTipoObbligatorioPredefinitoDescrizione
modelstringinfinitalkUsa infinitalk come ID modello API.
promptstring-Massimo 5000 caratteri per questo modello.
paramsobjectNo-Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite.
client_request_idstringNo-ID client facoltativo per tracciare le richieste nel tuo sistema.

Parametri del modello

KeyTipoObbligatorioPredefinitoIntervalloOpzioniDescrizione
resolutionselectNo480p-480p, 720pRisoluzione
seednumberNo-min 10000 / max 1000000-Lascialo vuoto per ottenere ogni volta un nuovo risultato casuale. Riutilizzare lo stesso numero intero rende più semplice riprodurre o rifinire un risultato precedente. Il risultato resta più vicino solo quando anche il prompt e le altre impostazioni chiave rimangono simili, e non garantisce una corrispondenza 1:1.

Regola di upload

Carica prima i file di riferimento, poi inserisci l'URL restituito e il durationToken dentro params.referenceMediaItems.

Regola di riferimento

Immagine ritratto e audio: Carica insieme un ritratto e una clip audio.

File massimi

2

Tipi di file accettati

image, audio

Duration token

I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.

kindDimensione massimaTipi MIME
image10 MBimage/jpeg, image/png, image/webp
audio10 MBaudio/mpeg, audio/wav, audio/x-wav, audio/aac, audio/mp4, audio/ogg

Richiesta minima

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

Richiesta con file di riferimento

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

Risposta di creazione

L'endpoint di creazione restituisce un ID task pubblico. Interroga l'endpoint di stato finché il task riesce o fallisce.

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

Errori comuni

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Alcune modalità richiedono upload di riferimento tramite Files API.