UlazAI fejlesztői dokumentumok
Kling 3.0 API dokumentumok létrehozásához, feltöltéséhez és árképzéséhez
Kling 3.0 referencia
Kling 3.0 API dokumentumok létrehozásához, feltöltéséhez és árképzéséhez
Használatához a Kling 3.0 API, kezdje itt:
használja POST /kling30/api/generate/ munkahelyeket teremteni,
GET /kling30/api/status/{task_id}/ a kimeneti állapot lekérdezéséhez, és
POST /kling30/api/upload/ forrás keretekhez. UlazAI támogatja
szövegből videóba és képről videóra opcionális hanggal,
több felvétel, kezdő és záró képkockák vezérlése, valamint másodpercenkénti díjszabás a normál, profi és 4K minőségi módokhoz.
Alapvető végpontok
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Jelenlegi támogatás
3-15 másodperces renderelés
Normál, pro vagy 4K minőség
Hang, több felvétel és keretvezérlés
Az ár másodpercenként értendő. Az időtartam teljes másodpercig tart 3 hogy
15. Engedélyezheti a Prompt Directory feliratkozást, hogy azonnali kérést alkalmazzon
-10 krediteket kedvezmény.
/kling30/api/generate/
Hozzon létre egy Kling 3.0 generációs feladatot.
Hitelesítés
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonKérelem szerve
{
"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
}Példa képről videóra
{
"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"
}Mezőhivatkozás
prompt (karakterlánc, kötelező, maximum 2500)
GenerationMode (kötelező): text_to_video vagy image_to_video
imageUrls (tömb): szükséges a kép-videóhoz, hacsak nincs megadva keret URL
időtartamMásodperc (kötelező): egész szám 3..15
QualityMode (kötelező): std, pro, vagy 4K
hangot (nem kötelező, logikai)
multiShots (nem kötelező, logikai)
oldalarány (nem kötelező): 16:9, 9:16, 1:1 (nem engedélyezett, ha a keret kezdő/vége URL-je be van állítva)
startFrameUrl, endFrameUrl (opcionális http(k) URL-ek)
prompt_directory_optin (opcionális, logikai érték): azonnali engedmény alkalmazása és automatikus megosztás siker esetén
Sikerreakció
{
"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}/
A feladat állapotának és kimeneti URL-jének lekérése, ha elkészült.
{
"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"
}
Állapot értékek: pending, processing, completed, failed.
Sikertelenség esetén a krediteket automatikusan visszatérítjük.
/kling30/api/upload/
Töltse fel a forrás/kezdő/vége keretképeket (JPEG/PNG/WebP, maximum 10 MB), és kapjon nyilvános URL-t a generálási kérésekhez.
Árképzési mátrix (kredit/másodperc)
Standard
Nincs hang: 20 / s
Hanggal: 30 / s
Pro
Nincs hang: 27 / s
Hanggal: 40 / s
4K
67 / s
cURL példa
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
}'Hibakódok
- 400 érvénytelen rakomány
- 401 érvénytelen hitelesítés
- 402 elégtelen kredit
- 429 díjszabású
- 500 upstream/szolgáltató vagy belső hiba