Sådan får du adgang til Klings AI-video via kode

Vil man lade et program lave AI-video automatisk i stedet for at klikke rundt på en hjemmeside, kan man bruge Klings API. Et API er en slags digital bestillingsluge, hvor ét program kan sende ordrer til et andet. Her er hovedtrækkene ifølge Klings egen dokumentation.

Fra nøgle til første video

Udviklerplatformen ligger på kling.ai/dev, og nøgler oprettes i konsollen på kling.ai/dev/api-key. Man klikker på »Create a new API Key« og giver nøglen et navn. Nøglen vises kun én gang, så den skal gemmes sikkert med det samme.

Før man kan bruge tjenesten, skal man købe ressourcepakker til video- eller billedgenerering. Ifølge en uafhængig vejledning fra Puter er det gratis at oprette nøglen, men hver genereret video koster penge. Prisen afhænger af model og kliplængde. Konsollen viser, hvor mange kald man har foretaget, hvor meget der er brugt, og hvad saldoen er.

I Klings officielle dokumentation er API-domænet https://api-singapore.klingai.com. Andre kilder nævner også api.klingai.com, så adressen kan variere.

To måder at logge ind på

Den nuværende standardmetode er at sende nøglen med i hver forespørgsel som »Authorization: Bearer <nøgle>«.

Der findes også en ældre metode med Access Key og Secret Key. Her skal programmet selv lave et såkaldt JWT, en slags midlertidig digital adgangsbillet. Den gælder i 1800 sekunder fra udstedelsen. Tredjepartsguider beskriver kun den ældre metode.

Kling har ifølge Puter ingen officiel SDK, altså et færdigt programbibliotek. Den community-udviklede npm-pakke »kling-api« klarer dog JWT og statusopfølgning.

Sådan forløber en bestilling

En videovirksomhed bestiller ikke og får svar med det samme. Ifølge dokumentationen fra videresælgeren CometAPI sender man en POST til /v1/videos/text2video, og senere forespørger man opgaven via GET /v1/videos/text2video/{task_id}. Opgaven kan have status submitted, processing, succeed eller failed, hvor de to sidste er sluttilstande. Stierne stammer fra en videresælger og kan afvige fra Klings direkte API.

Man kan enten spørge løbende (polling) eller angive en callback_url, så Kling sender resultatet til en HTTPS-adresse, man selv styrer. Polling anbefales stadig som sikkerhedsnet, hvis et callback udebliver.

Pas på nøglen

Klings dokumentation kalder nøglen meget følsom. Hvis den lækker, kan andre bruge af ens kaldekvote. Nøgler bør derfor ligge i miljøvariabler og ikke skrives direkte ind i koden.