Dokumenty pro vývojáře UlazAI
Kling 3.0 Dokumenty API pro generování, nahrávání a stanovení cen
Reference Kling 3.0
Kling 3.0 Dokumenty API pro generování, nahrávání a stanovení cen
Chcete-li použít Kling 3.0 API, začněte zde:
použití POST /kling30/api/generate/ vytvářet pracovní místa,
GET /kling30/api/status/{task_id}/ k dotazování stavu výstupu a
POST /kling30/api/upload/ pro zdrojové snímky. Podporuje UlazAI
převod textu na video a z obrázku na video s volitelným zvukem,
více snímků, ovládání začátku a konce snímku a ceny za sekundu pro standardní, profesionální a 4K režimy kvality.
Základní koncové body
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Aktuální podpora
3 až 15 sekund rendery
Standardní, profesionální nebo 4K kvalita
Ovládání zvuku, více snímků a snímků
Cena je za sekundu. Délka podporuje celé sekundy od 3 do
15. Můžete povolit přihlášení k adresáři Prompt pro okamžité použití
-10 kredity sleva.
/kling30/api/generate/
Vytvořte úlohu generování Kling 3.0.
Autentizace
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonTělo žádosti
{
"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říklad z obrázku na video
{
"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"
}Odkaz na pole
prompt (řetězec, povinný, max. 2500)
generationMode (vyžadováno): text_to_video nebo image_to_video
imageUrls (pole): vyžadováno pro převod obrazu na video, pokud nejsou uvedeny adresy URL snímků
trváníSekundy (povinné): celé číslo 3..15
qualityMode (vyžadováno): std, pronebo 4K
zvuk (volitelné, booleovské)
multiShots (volitelné, booleovské)
poměr stran (volitelné): 16:9, 9:16, 1:1 (není povoleno, pokud jsou nastaveny adresy URL počátečního/koncového rámce)
startFrameUrl, endFrameUrl (volitelné http(s) URL)
prompt_directory_optin (volitelně, boolean): při úspěchu uplatněte okamžitou slevu a automatické sdílení
Úspěšná odpověď
{
"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}/
Po dokončení získejte stav úlohy a výstupní adresu URL.
{
"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"
}
Stavové hodnoty: pending, processing, completed, failed.
Při neúspěchu jsou kredity vráceny automaticky.
/kling30/api/upload/
Nahrajte zdrojové/počáteční/koncové snímky snímků (JPEG/PNG/WebP, max. 10 MB) a získejte veřejnou adresu URL pro požadavky na generování.
Cenová matice (kredity za sekundu)
Norma
Žádný zvuk: 20 / s
Se zvukem: 30 / s
Pro
Žádný zvuk: 27 / s
Se zvukem: 40 / s
4K
67 / s
příklad cURL
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
}'Chybové kódy
- 400 neplatné užitečné zatížení
- 401 neplatná autentizace
- 402 nedostatečné kredity
- 429 sazba omezená
- 500 upstream/poskytovatel nebo interní selhání