Sari la conținut

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.

POSTĂ /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"
}
GET /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.

POSTĂ /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ă

Credite, modele și statut