Käytä mallia Kling V2.1 Pro Rivya Public API v1:n kautta malli-ID:llä kling-v2-1-pro; mukana ovat tuetut syötteet, parametrit, Files API -säännöt, krediitit ja vastausesimerkit.

Saatavilla API:n kauttaValmiusVideo

API-malli-ID

kling-v2-1-pro

Syötteet

file

Files API

Vaaditaan referenssimoodeissa

Peruskrediitit

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

Kyvykkyys

Video

Laskutus

FIXED

Prompt-raja

5000 merkkiä

Pyyntösopimus

Lähetä malli-ID ylätason kentässä. Mallikohtaiset ohjaimet kuuluvat params-objektiin.

Avain	Tyyppi	Pakollinen	Oletus	Kuvaus
model	string	Kyllä	kling-v2-1-pro	Käytä kling-v2-1-pro-arvoa API-malli-ID:nä.
prompt	string	Kyllä	-	Enintään 5000 merkkiä tälle mallille.
params	object	Ei	-	Mallikohtainen parametriobjekti. Käytä alla olevia rivejä sallittuihin avaimiin.
client_request_id	string	Ei	-	Valinnainen asiakaspuolen ID pyyntöjen jäljittämiseen omassa järjestelmässäsi.

Malliparametrit

Avain	Tyyppi	Pakollinen	Oletus	Alue	Vaihtoehdot	Kuvaus
duration	select	Ei	5	-	5, 10	Kesto
negative_prompt	text	Ei	-	-	-	Negatiivinen prompt
cfg_scale	number	Ei	0.5	min 0 / max 1 / step 0.1	-	Määrittää, kuinka tarkasti tulos seuraa promptiasi. Korkeammat arvot pysyvät yleensä lähempänä promptia, mutta voivat myös tehdä liikkeestä tai sommittelusta jäykemmän.

Latauskäytäntö

Lataa referenssitiedostot ensin ja sijoita sitten palautettu URL ja duration token params.referenceMediaItems-arvon sisään.

Referenssisääntö

Viitekuvat: Kuvatila hyväksyy enintään 2 kuvatiedostoa, ja toinen kuva kartoitetaan loppuruutuun. JPEG/PNG ≤ 10 MB.

Enimmäistiedostot

Hyväksytyt tiedostotyypit

image

Duration token

Video- ja äänireferenssien pitäisi kantaa /api/v1/files-reitin durationToken-arvoa, kun keston varmennus vaaditaan.

kind	Enimmäiskoko	MIME-tyypit
image	10 MB	image/jpeg, image/png

Minimipyyntö

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Kuvaile, mitä videon pitäisi välttää",
    "cfg_scale": 0.5
  }
}

Referenssitiedostopyyntö

{
  "model": "kling-v2-1-pro",
  "params": {
    "duration": "5",
    "negative_prompt": "Kuvaile, mitä videon pitäisi välttää",
    "cfg_scale": 0.5,
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png"
      }
    ]
  }
}

Create-vastaus

Create-endpoint palauttaa julkisen tehtävä-ID:n. Pollaa status-endpointia, kunnes tehtävä onnistuu tai epäonnistuu.

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

Yleiset virheet

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Jotkin moodit vaativat Files API -referenssilatauksia.

Kling V2.1 Pro API -integraatio