Documentație Rivya AI
Pagini API pentru modele

Integrare API Kling 2.6

Folosește Kling 2.6 prin Rivya Public API v1 cu ID-ul modelului kling-2-6, intrările acceptate, parametrii, regulile Files API, creditele și exemplele de răspuns.

Disponibil prin APIText sau URL gata; modurile de referință folosesc Files APIVideo
ID model API

kling-2-6

Intrări

text, file

Files API

Necesar pentru moduri de referință

Credite de bază

per_video · 5s_without_audio=55 · 5s_with_audio=110 · 10s_without_audio=110 · 10s_with_audio=220 · ⌈total⌉

Capabilitate

Video

Facturare

FIXED

Limită prompt

1000 caractere

Contract cerere

Trimite ID-ul modelului la nivelul superior. Opțiunile specifice modelului trebuie incluse în `params`.

CheieTipNecesarImplicitDescriere
modelstringDakling-2-6Folosește ID-ul de model API kling-2-6.
promptstringDa-Maximum 1000 caractere pentru acest model.
paramsobjectNu-Obiectul `params` conține parametrii specifici modelului. Folosește rândurile de mai jos pentru cheile permise.
client_request_idstringNu-ID opțional din partea clientului pentru urmărirea cererilor în sistemul tău.

Parametri model

CheieTipNecesarImplicitIntervalOpțiuniDescriere
durationselectNu5-5, 10Durată
soundselectNufalse-false, trueGenerează audio
aspect_ratioselectNu1:1-1:1, 16:9, 9:16Raport de aspect

Politică de încărcare

Încarcă mai întâi fișierele de referință, apoi adaugă URL-ul returnat și tokenul de durată în `params.referenceMediaItems`.

Regulă referință

Imagine de referință: Încarcă până la 1 fișier imagine pentru proiecte image-to-video. JPEG/PNG ≤ 10 MB.

Număr maxim de fișiere

1

Tipuri de fișiere acceptate

image

Token de durată

Referințele video și audio trebuie să includă câmpul `durationToken` returnat de `/api/v1/files` atunci când este necesară verificarea duratei.

kindDimensiune maximăTipuri MIME
image10 MBimage/jpeg, image/png

Cerere minimă

{
  "model": "kling-2-6",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1"
  }
}

Cerere cu fișier de referință

{
  "model": "kling-2-6",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "duration": "5",
    "sound": "false",
    "aspect_ratio": "1:1",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Răspuns la creare

Endpointul de creare returnează un ID public al sarcinii. Interoghează endpointul de stare până când sarcina reușește sau eșuează.

{
  "id": "task_kling_2_6_example",
  "status": "queued",
  "model": "kling-2-6",
  "reserved_credits": 55,
  "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
}

Erori comune

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Unele moduri necesită încărcări de referință prin Files API.