Usa Kling V2.5 Turbo Pro tramite Rivya Public API v1 con model id kling-v2-5-turbo-pro, input supportati, parametri, regole Files API, crediti ed esempi di risposta.

Disponibile via APITesto o URL pronti; le modalità di riferimento usano Files APIVideo

ID modello API

kling-v2-5-turbo-pro

Input

text, file

Files API

Richiesto per le modalità con riferimento

Crediti base

Capacità

Video

Fatturazione

FIXED

Limite prompt

2500 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ì	kling-v2-5-turbo-pro	Usa kling-v2-5-turbo-pro come ID modello API.
prompt	string	Sì	-	Massimo 2500 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
duration	select	No	5	-	5, 10	Durata
aspect_ratio	select	No	16:9	-	16:9, 9:16, 1:1	Rapporto d'aspetto
negative_prompt	text	No	-	-	-	Prompt negativo
cfg_scale	number	No	0.5	min 0 / max 1	-	Controlla quanto strettamente il risultato segue il prompt. Valori più alti di solito restano più vicini al prompt, ma possono anche rendere movimento o composizione più rigidi.

Regola di upload

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

Regola di riferimento

Immagini di riferimento: Carica opzionalmente fino a 2 immagini per passare alla modalità image-to-video; la seconda immagine viene mappata al tail frame.

File massimi

Tipi di file accettati

image

Duration token

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

Richiesta minima

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descrivi cosa il video dovrebbe evitare",
    "cfg_scale": 0.5
  }
}

Richiesta con file di riferimento

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Descrivi cosa il video dovrebbe evitare",
    "cfg_scale": 0.5,
    "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_kling_v2_5_turbo_pro_example",
  "status": "queued",
  "model": "kling-v2-5-turbo-pro",
  "reserved_credits": 42,
  "final_credits": 0,
  "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.

Integrazione API di Kling V2.5 Turbo Pro