Kling O3 API-integration
Använd Kling O3 via Rivyas publika API v1 med modell-ID kling-o3, stödda inmatningar, parametrar, Files API-regler, krediter och svarsexempel.
kling-o3
text, file
Krävs för referenslägen
per_output_second · 720p_without_audio=14 · 720p_with_audio=18 · 1080p_without_audio=18 · 1080p_with_audio=23 · 4k_without_audio=67 · 4k_with_audio=67 · ⌈total⌉
Video
METERED
3072 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-o3 | Använd API-modell-ID:t kling-o3. |
| prompt | string | Ja | - | Högst 3072 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 |
|---|---|---|---|---|---|---|
| resolution | select | Nej | 720p | - | 720p, 1080p, 4k | Genereringsläge |
| duration | select | Nej | 5 | - | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Längd |
| audio | select | Nej | false | - | false, true | Generera ljud |
| aspect_ratio | select | Nej | 16:9 | - | 16:9, 9:16, 1:1 | Bildförhållande |
Uppladdningspolicy
Ladda först upp referensfiler och placera sedan den returnerade URL:en och varaktighetstoken i params.referenceMediaItems.
Referensmedia: Ladda upp upp till 2 bildfiler totalt för bild-till-video-projekt.
2
image
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-o3",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"audio": "false",
"aspect_ratio": "16:9"
}
}Begäran med referensfil
{
"model": "kling-o3",
"prompt": "A cinematic product reveal with smooth camera movement",
"params": {
"resolution": "720p",
"duration": "5",
"audio": "false",
"aspect_ratio": "16:9",
"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_o3_example",
"status": "queued",
"model": "kling-o3",
"reserved_credits": 70,
"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.