Skip to main content
Denna artikel kommer att introducera en Kling Motion Generation API integrationsbeskrivning, som kan generera Kling officiella videor genom att ange anpassade parametrar.

​
Ansökningsprocess

För att använda Kling Motion Generation API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara. Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token kan användas för att anropa alla tjänster på plattformen, utan att behöva ansöka separat för varje tjänst. Första gången du ansöker får du en gratis kvot för att prova; om kvoten tar slut kan du ladda på allmän balans i konsolen.
📘 Fullständig dokumentation: Kling Motion Generation API →

​
Grundläggande användning

Först bör du förstå den grundläggande användningen, vilket innebär att du anger en prompt prompt, en referensbild image_url och en referensvideolänk video_url, för att få det bearbetade resultatet. Vi behöver också ange modellen mode, som för närvarande huvudsakligen har modellerna std och pro, med följande specifikationer:

Här kan vi se att vi har ställt in Request Headers, inklusive:
  • accept: vilken format av svar du vill ta emot, här anges som application/json, det vill säga JSON-format.
  • authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.
Dessutom har vi ställt in Request Body, inklusive:
  • image_url: URL för referensbild av personens utseende. Stöder JPG/JPEG/PNG, fil ≤50MB, bredd och höjd ≥300px, bildförhållande 1:2.5～2.5:1; personen ska tydligt visas i överkropp eller helkropp samt huvud.
  • video_url: URL för referensvideon. Stöder MP4/MOV, fil ≤100MB, bredd och höjd 340–3850px, minst 3 sekunder; character_orientation=image max 10 sekunder, character_orientation=video max 30 sekunder. Det rekommenderas att använda en kontinuerlig enskild tagning där personen alltid är inom ramen.
  • mode: läget för att generera videon, huvudsakligen standardläge std och snabbläge pro.
  • keep_original_sound: kan välja om den ursprungliga ljudet i videon ska behållas, möjliga värden: yes, no.
  • character_orientation: riktningen för personen i den genererade videon, kan väljas att vara densamma som bilden eller videon, möjliga värden: image, video.
  • prompt: prompt.
  • callback_url: URL för att ta emot callback-resultat.
  • async: valfritt, sätts till true för att omedelbart returnera task_id, utan att behöva ange callback_url, och sedan kan resultatet hämtas genom att fråga motsvarande uppgiftsgränssnitt.
När du har gjort dina val kan du se att motsvarande kod har genererats till höger, som visas i bilden:

Klicka på “Try” knappen för att testa, som visas i bilden ovan, och vi får följande resultat:
Det returnerade resultatet har flera fält, som beskrivs nedan:
  • success, status för videogenereringsuppgiften.
  • task_id, ID för videogenereringsuppgiften.
  • video_id, videons ID för videogenereringsuppgiften.
  • video_url, videons länk för videogenereringsuppgiften.
  • duration, längden på videon för videogenereringsuppgiften.
  • state, status för videogenereringsuppgiften.
Vi kan se att vi har fått tillfredsställande videoinformation, och vi behöver bara hämta den genererade Kling-videon baserat på videolänken i data. Om du vill generera motsvarande integrationskod kan du direkt kopiera den, till exempel CURL-koden nedan:

​
Asynkron callback

Eftersom Kling Motion Generation API:s genereringstid är relativt lång, cirka 1-2 minuter, om HTTP-förfrågan inte får något svar under en längre tid, kommer anslutningen att hållas öppen, vilket leder till extra systemresursförbrukning. Därför erbjuder detta API också stöd för asynkron callback. Den övergripande processen är: när klienten initierar en begäran, specificerar den ett extra callback_url-fält. Efter att klienten har initierat API-begäran kommer API:et omedelbart att returnera ett resultat som innehåller ett task_id-fält, vilket representerar det aktuella uppgifts-ID:t. När uppgiften är klar kommer resultatet av den genererade videon att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id-fältet, så att uppgiftsresultatet kan kopplas ihop med ID:t. Låt oss förstå hur man gör detta genom ett exempel. Först är Webhook-callback en tjänst som kan ta emot HTTP-förfrågningar, utvecklare bör ersätta med URL:en för sin egen HTTP-server. För att underlätta demonstration använder vi en offentlig Webhook-exempelsida https://webhook.site/, öppna denna webbplats för att få en Webhook-URL, som visas i bilden: Kopiera denna URL, så kan den användas som Webhook, exempelvis https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3. Därefter kan vi ställa in fältet callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i motsvarande parametrar, som visas i bilden:

Klicka på kör, och du kan se att du omedelbart får ett resultat, som nedan:
Vänta en stund, så kan vi observera resultatet av den genererade videon på https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3, som visas i bilden: Innehållet är som följer:
Det kan ses att resultatet innehåller ett task_id fält, de andra fälten liknar de ovan, och genom detta fält kan uppgifterna kopplas samman.

​
Felhantering

Vid anrop av API:et, om ett fel uppstår, kommer API:et att returnera motsvarande felkod och information. Till exempel:
  • 400 token_mismatched: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 400 api_not_implemented: Felaktig begäran, möjligtvis på grund av saknade eller ogiltiga parametrar.
  • 401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
  • 429 too_many_requests: För många begärningar, du har överskridit hastighetsgränsen.
  • 500 api_error: Intern serverfel, något gick fel på servern.

​
Exempel på felrespons

​
Slutsats

Genom detta dokument har du fått en förståelse för hur man använder Kling Motion Generation API för att implementera Kling officiella rörelsekontrollfunktioner. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda detta API. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.