Rivya AI-dokumentation
Modellsidor för API

Kling V2.5 Turbo Pro API-integration

Använd Kling V2.5 Turbo Pro via Rivyas publika API v1 med modell-ID kling-v2-5-turbo-pro, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.

Tillgänglig via APIText eller URL klar; referenslägen använder Files APIVideo
API-modell-ID

kling-v2-5-turbo-pro

Inmatningar

text, file

Files API

Krävs för referenslägen

Baskrediter

42

Förmåga

Video

Fakturering

FIXED

Promptgräns

2500 tecken

Kontrakt för begäran

Skicka modell-ID:t på toppnivå. Modellspecifika kontroller hör hemma i params.

NyckelTypObligatorisktStandardBeskrivning
modelstringJakling-v2-5-turbo-proAnvänd API-modell-ID:t kling-v2-5-turbo-pro.
promptstringJa-Högst 2500 tecken för den här modellen.
paramsobjectNej-Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_idstringNej-Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

NyckelTypObligatorisktStandardIntervallAlternativBeskrivning
durationselectNej5-5, 10Längd
aspect_ratioselectNej16:9-16:9, 9:16, 1:1Bildförhållande
negative_prompttextNej---Negativ prompt
cfg_scalenumberNej0.5min 0 / max 1-Styr hur tätt resultatet följer din prompt. Högre värden håller sig oftast närmare prompten, men kan också få rörelse eller komposition att kännas stelare.

Uppladdningspolicy

Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.

Referensregel

Referensbilder: Ladda valfritt upp upp till 2 bilder för att växla till bild-till-video-läge; den andra bilden mappas till slutbilden.

Max filer

2

Godkända filtyper

image

Varaktighetstoken

Video- och ljudreferenser bör innehålla durationToken från /api/v1/files när varaktighetsverifiering krävs.

kindMax storlekMIME-typer
image10 MBimage/jpeg, image/png, image/webp

Minimal begäran

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beskriv vad videon ska undvika",
    "cfg_scale": 0.5
  }
}

Begäran med referensfil

{
  "model": "kling-v2-5-turbo-pro",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "aspect_ratio": "16:9",
    "negative_prompt": "Beskriv vad videon ska undvika",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Skapa-svar

Create-endpointen returnerar ett publikt uppgifts-ID. Kontrollera status-endpointen tills uppgiften lyckas eller misslyckas.

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

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Vissa lägen kräver referensuppladdningar via Files API.