Hopp til innholdet

UlazAI utviklerdokumenter

Kling 3.0 API-dokumenter for generering, opplasting og prissetting

Kling 3.0 referanse

Kling 3.0 API-dokumenter for generering, opplasting og prissetting

For å bruke Kling 3.0 API, start her: bruk POST /kling30/api/generate/ å skape arbeidsplasser, GET /kling30/api/status/{task_id}/ for å polle utdatastatus, og POST /kling30/api/upload/ for kilderammer. UlazAI støtter tekst-til-video og bilde-til-video med valgfri lyd, multi-shots, start- og sluttbildekontroll og pris per sekund for standard-, pro- og 4K-kvalitetsmoduser.

Kjerneendepunkter

POST /kling30/api/generate/

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

POST /kling30/api/upload/

Nåværende støtte

3 til 15 sekunder gjengivelser

Standard, pro eller 4K kvalitet

Lyd, multibilder og rammekontroll

Prisen er per sekund. Varighet støtter hele sekunder fra 3 til 15. Du kan aktivere forespørselskatalog-opt-in for å søke en umiddelbar -10 kreditter rabatt.

POST /kling30/api/generate/

Opprett en Kling 3.0 generasjonsoppgave.

Autentisering

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Forespørselsinstans

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

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

Feltreferanse

prompt (streng, obligatorisk, maks 2500)

generasjonsmodus (obligatorisk): text_to_video eller image_to_video

imageUrls (matrise): kreves for bilde-til-video med mindre ramme-URL-er er oppgitt

varighetSekunder (påkrevd): heltall 3..15

kvalitetsmodus (obligatorisk): std, pro, eller 4K

lyd (valgfritt, boolsk)

multiShots (valgfritt, boolsk)

aspektforhold (valgfritt): 16:9, 9:16, 1:1 (ikke tillatt når nettadresser for start/sluttramme er angitt)

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

prompt_directory_optin (valgfritt, boolsk): bruk øyeblikkelig rabatt og autodeling ved suksess

Suksessrespons

{
  "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å oppgavestatus og utdata-URL når du er ferdig.

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

Statusverdier: pending, processing, completed, failed. Ved feil refunderes kreditter automatisk.

POST /kling30/api/upload/

Last opp kilde-/start-/sluttbilder (JPEG/PNG/WebP, maks 10 MB) og motta en offentlig URL for generasjonsforespørsler.

Prismatrise (kreditter per 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
  }'

Feilkoder

  • 400 ugyldig nyttelast
  • 401 ugyldig autentisering
  • 402 utilstrekkelig kreditter
  • 429 satsbegrenset
  • 500 oppstrøms/leverandør eller intern feil

Kreditter, modeller og status