UlazAI kehittäjädokumentit
Kling 3.0 API asiakirjat luomiseen, lataamiseen ja hinnoitteluun
Kling 3.0 viite
Kling 3.0 API asiakirjat luomiseen, lataamiseen ja hinnoitteluun
Käyttääksesi Kling 3.0 API, aloita tästä:
käyttää POST /kling30/api/generate/ luoda työpaikkoja,
GET /kling30/api/status/{task_id}/ kyselyn tulosteen tilaan ja
POST /kling30/api/upload/ lähdekehyksiin. UlazAI tukee
tekstistä videoksi ja kuvasta videoon valinnaisella äänellä,
useat otokset, aloitus- ja loppukuvan ohjaus ja sekuntikohtainen hinnoittelu vakio-, pro- ja 4K-laatutiloissa.
Ydinpäätepisteet
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Nykyinen tuki
3-15 sekunnin renderöinti
Vakio-, pro- tai 4K-laatu
Ääni, multi-shots ja kehysohjaus
Hinta on sekunti. Kesto tukee kokonaisia sekunteja alkaen 3 to
15. Voit ottaa Prompt Directory -valinnan käyttöön ottaaksesi välittömän
-10 krediittejä alennus.
/kling30/api/generate/
Luo Kling 3.0-sukupolvitehtävä.
Todennus
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonPyynnön runko
{
"prompt": "A cinematic tracking shot following a cyclist through a rainy neon city street.",
"generationMode": "text_to_video",
"durationSeconds": 8,
"qualityMode": "4K",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}Esimerkki kuvasta videoon
{
"prompt": "The portrait slowly smiles while camera pushes in.",
"generationMode": "image_to_video",
"imageUrls": ["https://example.com/source.jpg"],
"durationSeconds": 5,
"qualityMode": "std",
"sound": false,
"startFrameUrl": "https://example.com/start.jpg",
"endFrameUrl": "https://example.com/end.jpg"
}Kenttäviittaus
prompt (merkkijono, pakollinen, enintään 2500)
GenerationMode (pakollinen): text_to_video tai image_to_video
imageUrls (matriisi): vaaditaan kuvasta videoon, ellei kehyksen URL-osoitteita ole annettu
kestoSekuntia (pakollinen): kokonaisluku 3...15
laatutila (pakollinen): std, pro, tai 4K
ääni (valinnainen, looginen)
multiShots (valinnainen, looginen)
kuvasuhde (valinnainen): 16:9, 9:16, 1:1 (ei sallittu, kun aloitus-/loppukehyksen URL-osoitteet on asetettu)
startFrameUrl, endFrameUrl (valinnaiset http-URL-osoitteet)
prompt_directory_optin (valinnainen, looginen): käytä välitöntä alennusta ja jaa automaattisesti onnistumisen yhteydessä
Menestysvastaus
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"provider_task_id": "281e5b0...f39b9",
"status": "processing",
"credits_used": 310,
"directory_discount_applied": 10,
"estimated_time": "varies by queue"
}/kling30/api/status/{task_id}/
Hanki tehtävän tila ja tulostettava URL-osoite, kun se on valmis.
{
"success": true,
"task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"status": "completed",
"video_url": "https://cdn.example.com/path/output.mp4",
"credits_charged": 310,
"prompt_submission_id": "70f4f6a9-2d17-4f31-81ac-8d57eecb9e21"
}
Tilan arvot: pending, processing, completed, failed.
Epäonnistuessa hyvitykset palautetaan automaattisesti.
/kling30/api/upload/
Lataa lähde-/aloitus-/loppukehyskuvat (JPEG/PNG/WebP, enintään 10 Mt) ja vastaanota julkinen URL-osoite luontipyyntöjä varten.
Hinnoittelumatriisi (krediittiä sekunnissa)
Vakio
Ei ääntä: 20 / s
Äänen kanssa: 30 / s
Pro
Ei ääntä: 27 / s
Äänen kanssa: 40 / s
4K
67 / s
cURL-esimerkki
curl -X POST https://ulazai.com/kling30/api/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A heroic wide shot of a spaceship entering orbit above Earth.",
"generationMode": "text_to_video",
"durationSeconds": 10,
"qualityMode": "pro",
"sound": true,
"multiShots": true,
"aspectRatio": "16:9",
"prompt_directory_optin": true
}'Virhekoodit
- 400 virheellinen hyötykuorma
- 401 virheellinen todennus
- 402 riittämättömät luottot
- 429 korkorajoitettu
- 500 ylävirtaan/toimittaja tai sisäinen vika