UlazAI documente pentru dezvoltatori
Kling 3.0 API documente pentru generarea, încărcarea și stabilirea prețurilor
Referință Kling 3.0
Kling 3.0 API documente pentru generarea, încărcarea și stabilirea prețurilor
Pentru a utiliza Kling 3.0 API, începe aici:
folosi POST /kling30/api/generate/ pentru a crea locuri de muncă,
GET /kling30/api/status/{task_id}/ pentru a interoga starea ieșirii și
POST /kling30/api/upload/ pentru cadrele sursă. UlazAI suportă
text-to-video şi imagine-la-video cu audio optional,
mai multe fotografii, controlul cadrelor de început și de sfârșit și prețuri pe secundă pentru modurile de calitate standard, pro și 4K.
Puncte finale de bază
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Suport curent
Redări de la 3 la 15 secunde
Calitate standard, pro sau 4K
Audio, mai multe fotografii și control al cadrelor
Prețul este pe secundă. Durata acceptă secunde întregi de la 3 la
15. Puteți activa înscrierea în Prompt Directory pentru a aplica o solicitare imediată
-10 credite reducere.
/kling30/api/generate/
Creați o sarcină de generare Kling 3.0.
Autentificare
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Corpul cererii
{
"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
}
Exemplu imagine-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"
}
Referință de câmp
prompt (șir, necesar, max 2500)
generationMode (obligatoriu): text_to_video sau image_to_video
imageUrls (matrice): necesar pentru imaginea-video, cu excepția cazului în care sunt furnizate adrese URL ale cadrelor
durataSecunde (obligatoriu): întreg 3..15
qualityMode (obligatoriu): std, pro, sau 4K
sunet (opțional, boolean)
multiShots (opțional, boolean)
aspectRatio (opțional): 16:9, 9:16, 1:1 (nu este permis când sunt setate adrese URL ale cadrelor de început/sfârșit)
startFrameUrl, endFrameUrl (adrese URL http(e) opționale)
prompt_directory_optin (opțional, boolean): aplică reducere imediată și distribuire automată la succes
Răspuns de succes
{
"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}/
Obțineți starea sarcinii și adresa URL de ieșire când este finalizată.
{
"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"
}
Valori de stare: pending, processing, completed, failed.
În caz de eșec, creditele sunt rambursate automat.
/kling30/api/upload/
Încărcați imagini cadru sursă/pornire/sfârșit (JPEG/PNG/WebP, max 10 MB) și primiți o adresă URL publică pentru solicitările de generare.
Matrice de prețuri (credite pe secundă)
Standard
Fără audio: 20 / s
Cu audio: 30 / s
Pro
Fără audio: 27 / s
Cu audio: 40 / s
4K
67 / s
exemplu 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
}'
Coduri de eroare
- 400 sarcină utilă invalidă
- 401 autentificare nevalidă
- 402 credite insuficiente
- 429 cu tarif limitat
- 500 amonte/furnizor sau defecțiune internă