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.
infinitalk
file
Richiesto per le modalità con riferimento
per_input_second · 480p=3 · 720p=12 · ⌈total⌉
Video
METERED
5000 caratteri
Contratto della richiesta
Invia l'ID modello al livello superiore. I controlli specifici del modello vanno in params.
| Key | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
| model | string | Sì | infinitalk | Usa infinitalk come ID modello API. |
| prompt | string | Sì | - | Massimo 5000 caratteri per questo modello. |
| params | object | No | - | Oggetto parametri specifico del modello. Usa le righe sotto per le key consentite. |
| client_request_id | string | No | - | ID client facoltativo per tracciare le richieste nel tuo sistema. |
Parametri del modello
| Key | Tipo | Obbligatorio | Predefinito | Intervallo | Opzioni | Descrizione |
|---|---|---|---|---|---|---|
| resolution | select | No | 480p | - | 480p, 720p | Risoluzione |
| seed | number | No | - | 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.
Immagine ritratto e audio: Carica insieme un ritratto e una clip audio.
2
image, audio
I riferimenti video e audio devono includere durationToken da /api/v1/files quando è richiesta la verifica della durata.
| kind | Dimensione massima | Tipi MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png, image/webp |
| audio | 10 MB | audio/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.