Gå til indhold

UlazAI udviklerdokumenter

Kling 3.0 API-dokumenter til generering, upload og prisfastsættelse

Kling 3.0 reference

Kling 3.0 API-dokumenter til generering, upload og prisfastsættelse

For at bruge Kling 3.0 API, start her: bruge POST /kling30/api/generate/ at skabe arbejdspladser, GET /kling30/api/status/{task_id}/ for at polle outputstatus, og POST /kling30/api/upload/ til kilderammer. UlazAI understøtter tekst-til-video og billede-til-video med valgfri lyd, multi-shots, start- og slutframe-kontrol og pris pr. sekund for standard-, pro- og 4K-kvalitetstilstande.

Kerneendepunkter

POST /kling30/api/generate/

GET /kling30/api/status/{task_id}/

POST /kling30/api/upload/

Aktuel support

3 til 15 sekunders gengivelser

Standard, pro eller 4K kvalitet

Lyd, multi-shots og billedkontrol

Prisen er pr. sekund. Varighed understøtter hele sekunder fra 3 til 15. Du kan aktivere Prompt Directory opt-in for at anvende en øjeblikkelig -10 kreditter rabat.

POST /kling30/api/generate/

Opret en Kling 3.0 generationsopgave.

Autentificering

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Anmodningsorgan

{
  "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
}

Billede-til-video eksempel

{
  "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"
}

Feltreference

prompt (streng, påkrævet, maks. 2500)

generationstilstand (påkrævet): text_to_video eller image_to_video

billedwebadresser (array): påkrævet for billede-til-video, medmindre ramme-URL'er er angivet

varighed Sekunder (påkrævet): heltal 3..15

kvalitetstilstand (påkrævet): std, pro, eller 4K

lyd (valgfrit, boolesk)

multiShots (valgfrit, boolesk)

aspektforhold (valgfrit): 16:9, 9:16, 1:1 (ikke tilladt, når start-/slutframe-URL'er er angivet)

startFrameUrl, endFrameUrl (valgfri http(er) URL'er)

prompt_directory_optin (valgfrit, boolesk): Anvend øjeblikkelig rabat og autodeling ved succes

Succes svar

{
  "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"
}
FÅ /kling30/api/status/{task_id}/

Få opgavestatus og output-URL, når du er færdig.

{
  "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"
}

Statusværdier: pending, processing, completed, failed. Ved fejl refunderes kreditter automatisk.

POST /kling30/api/upload/

Upload kilde-/start-/slutbilleder (JPEG/PNG/WebP, maks. 10 MB) og modtag en offentlig URL til genereringsanmodninger.

Prismatrix (kreditter pr. sekund)

Standard

Ingen lyd: 20 / s

Med lyd: 30 / s

Pro

Ingen lyd: 27 / s

Med lyd: 40 / s

4K

67 / s

cURL eksempel

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
  }'

Fejlkoder

  • 400 ugyldig nyttelast
  • 401 ugyldig godkendelse
  • 402 utilstrækkelige kreditter
  • 429 satsbegrænset
  • 500 upstream/udbyder eller intern fejl

Krediteringer, modeller og status