UlazAI Entwicklerdokumentation
Kling 3.0 API Dokumente zum Generieren, Hochladen und Bepreisen
Kling 3.0-Referenz
Kling 3.0 API Dokumente zum Generieren, Hochladen und Bepreisen
Um das zu nutzen Kling 3.0 API, beginnen Sie hier:
verwenden POST /kling30/api/generate/ Arbeitsplätze schaffen,
GET /kling30/api/status/{task_id}/ um den Ausgabestatus abzufragen und
POST /kling30/api/upload/ für Quellframes. UlazAI unterstützt
Text-zu-Video und Bild-zu-Video mit optionalem Audio,
Mehrfachaufnahmen, Start- und Endbildsteuerung und sekundengenaue Preisgestaltung für Standard-, Pro- und 4K-Qualitätsmodi.
Kernendpunkte
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Aktuelle Unterstützung
3 bis 15 Sekunden lange Renderings
Standard-, Pro- oder 4K-Qualität
Audio, Mehrfachaufnahmen und Bildsteuerung
Die Preise gelten pro Sekunde. Die Dauer unterstützt ganze Sekunden ab 3 zu
15. Sie können das Prompt Directory-Opt-in aktivieren, um eine sofortige Anwendung anzuwenden
-10 Credits Rabatt.
/kling30/api/generate/
Erstellen Sie eine Kling 3.0-Generierungsaufgabe.
Authentifizierung
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Anforderungstext
{
"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
}
Bild-zu-Video-Beispiel
{
"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"
}
Feldreferenz
prompt (Zeichenfolge, erforderlich, max. 2500)
generationMode (erforderlich): text_to_video oder image_to_video
imageUrls (Array): erforderlich für Bild-zu-Video, sofern keine Frame-URLs angegeben sind
DauerSekunden (erforderlich): Ganzzahl 3..15
Qualitätsmodus (erforderlich): std, pro, oder 4K
Ton (optional, boolesch)
MultiShots (optional, boolesch)
Aspektverhältnis (optional): 16:9, 9:16, 1:1 (nicht zulässig, wenn Start-/End-Frame-URLs festgelegt sind)
startFrameUrl, endFrameUrl (optionale http(s)-URLs)
prompt_directory_optin (optional, boolesch): Sofortrabatt anwenden und bei Erfolg automatisch teilen
Erfolgsantwort
{
"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}/
Rufen Sie nach Abschluss den Aufgabenstatus und die Ausgabe-URL ab.
{
"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"
}
Statuswerte: pending, processing, completed, failed.
Bei Nichtbestehen werden die Credits automatisch zurückerstattet.
/kling30/api/upload/
Laden Sie Quell-/Start-/End-Frame-Bilder hoch (JPEG/PNG/WebP, max. 10 MB) und erhalten Sie eine öffentliche URL für Generierungsanfragen.
Preismatrix (Credits pro Sekunde)
Standard
Kein Ton: 20 / s
Mit Audio: 30 / s
Profi
Kein Ton: 27 / s
Mit Audio: 40 / s
4K
67 / s
cURL-Beispiel
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
}'
Fehlercodes
- 400 ungültige Nutzlast
- 401 Ungültige Authentifizierung
- 402 unzureichende Kredite
- 429 satzbegrenzt
- 500 Upstream-/Provider- oder interner Fehler
Credits, Models und Status
Kling 3.0 API: erst Upload und Jobstatus sauber verbinden
Eine robuste Integration trennt Datei-Upload, Generierungsauftrag und Statusabfrage. Speichere die zurückgegebene Job-ID und behandle Fehlerzustände ausdrücklich, statt einen erfolgreichen HTTP-Aufruf mit einem fertigen Video gleichzusetzen.
Prüfe Modell, Eingabefelder und aktuelle Creditkosten in dieser Referenz, bevor du einen Produktionsjob sendest. Veraltete Beispielwerte gehören nicht in Clientcode.