Documentation du développeur UlazAI
Documents Kling 3.0 API pour la génération, le téléchargement et la tarification
Référence Kling 3.0
Documents Kling 3.0 API pour la génération, le téléchargement et la tarification
Pour utiliser le Kling 3.0 API, commencez ici :
utiliser POST /kling30/api/generate/ pour créer des emplois,
GET /kling30/api/status/{task_id}/ pour interroger l'état de la sortie, et
POST /kling30/api/upload/ pour les images sources. UlazAI prend en charge
texte en vidéo et image vers vidéo avec audio en option,
prises de vue multiples, contrôle de début et de fin d'image et tarification à la seconde pour les modes de qualité standard, pro et 4K.
Points de terminaison principaux
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Prise en charge actuelle
Rendus de 3 à 15 secondes
Qualité standard, pro ou 4K
Audio, prises de vue multiples et contrôle du cadre
Itinéraires suivants
Le prix est par seconde. La durée prend en charge des secondes entières à partir de 3 à
15. Vous pouvez activer l'inscription à Prompt Directory pour appliquer une notification immédiate.
-10 crédits remise.
/kling30/api/generate/
Créez une tâche de génération Kling 3.0.
Authentification
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonCorps de la demande
{
"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
}Exemple de conversion d'image en vidéo
{
"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"
}Référence du champ
prompt (chaîne, obligatoire, max 2500)
mode génération (obligatoire) : text_to_video ou image_to_video
URL d'image (tableau) : requis pour la conversion d'image en vidéo, sauf si les URL des images sont fournies
duréeSecondes (obligatoire) : entier 3..15
Modequalité (obligatoire) : std, pro, ou 4K
du son (facultatif, booléen)
multiShots (facultatif, booléen)
rapport d'aspect (facultatif) : 16:9, 9:16, 1:1 (non autorisé lorsque les URL de début/fin de cadre sont définies)
startFrameUrl, endFrameUrl (URL http(s) facultatives)
prompt_directory_optin (facultatif, booléen) : appliquer une remise immédiate et partager automatiquement en cas de succès
Réponse réussie
{
"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}/
Obtenez l’état de la tâche et l’URL de sortie une fois terminée.
{
"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"
}
Valeurs d'état : pending, processing, completed, failed.
En cas d'échec, les crédits sont automatiquement remboursés.
/kling30/api/upload/
Téléchargez les images source/début/fin (JPEG/PNG/WebP, max 10 Mo) et recevez une URL publique pour les demandes de génération.
Matrice de tarification (crédits par seconde)
Standard
Pas de son : 20 /s
Avec le son : 30 /s
Pro
Pas de son : 27 /s
Avec le son : 40 /s
4K
67 /s
exemple de boucle
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
}'Codes d'erreur
- 400 charge utile invalide
- 401 authentification invalide
- 402 crédits insuffisants
- 429 à taux limité
- 500 échec en amont/fournisseur ou interne