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

Tillgänglig via APIBeredskapVideo

API-modell-ID

kling-v2-1-pro

Inmatningar

file

Files API

Krävs för referenslägen

Baskrediter

per_video · 5s=50 · 10s=100 · ⌈total⌉

Förmåga

Video

Fakturering

FIXED

Promptgräns

5000 tecken

Kontrakt för begäran

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

Nyckel	Typ	Obligatoriskt	Standard	Beskrivning
model	string	Ja	kling-v2-1-pro	Använd API-modell-ID:t kling-v2-1-pro.
prompt	string	Ja	-	Högst 5000 tecken för den här modellen.
params	object	Nej	-	Modellspecifikt parameterobjekt. Använd raderna nedan för tillåtna nycklar.
client_request_id	string	Nej	-	Valfritt klient-ID för att spåra begäranden i ditt system.

Modellparametrar

Nyckel	Typ	Obligatoriskt	Standard	Intervall	Alternativ	Beskrivning
duration	select	Nej	5	-	5, 10	Längd
negative_prompt	text	Nej	-	-	-	Negativ prompt
cfg_scale	number	Nej	0.5	min 0 / max 1 / step 0.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: Bildläge accepterar upp till 2 bildfiler, och den andra bilden mappas till slutbilden. JPEG/PNG ≤ 10 MB.

Max filer

Godkända filtyper

image

Varaktighetstoken

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

kind	Max storlek	MIME-typer
image	10 MB	image/jpeg, image/png

Minimal begäran

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Beskriv vad videon ska undvika",
    "cfg_scale": 0.5
  }
}

Begäran med referensfil

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "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_1_pro_example",
  "status": "queued",
  "model": "kling-v2-1-pro",
  "reserved_credits": 50,
  "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
}

Vanliga fel

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

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

Kling V2.1 Pro API-integration