Έγγραφα προγραμματιστή UlazAI
Kling 3.0 API έγγραφα για δημιουργία, μεταφόρτωση και τιμολόγηση
Αναφορά Kling 3.0
Kling 3.0 API έγγραφα για δημιουργία, μεταφόρτωση και τιμολόγηση
Για να χρησιμοποιήσετε το Kling 3.0 API, ξεκινήστε εδώ:
χρήση POST /kling30/api/generate/ για τη δημιουργία θέσεων εργασίας,
GET /kling30/api/status/{task_id}/ για δημοσκόπηση κατάστασης εξόδου και
POST /kling30/api/upload/ για πλαίσια πηγής. Υποστηρίζει UlazAI
κείμενο σε βίντεο και εικόνα σε βίντεο με προαιρετικό ήχο,
πολλαπλές λήψεις, έλεγχος καρέ έναρξης και λήξης και τιμολόγηση ανά δευτερόλεπτο για τυπικές, επαγγελματικές και ποιοτικές λειτουργίες 4K.
Βασικά τελικά σημεία
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Τρέχουσα υποστήριξη
Αποδόσεις 3 έως 15 δευτερολέπτων
Τυπική, pro ή 4K ποιότητα
Έλεγχος ήχου, πολλαπλών λήψεων και καρέ
Επόμενες διαδρομές
Η τιμολόγηση είναι ανά δευτερόλεπτο. Η διάρκεια υποστηρίζει ολόκληρα δευτερόλεπτα από 3 να
15. Μπορείτε να ενεργοποιήσετε τη δήλωση συμμετοχής στο Prompt Directory για να εφαρμόσετε μια άμεση
-10 πιστώσεις έκπτωση.
/kling30/api/generate/
Δημιουργήστε μια εργασία δημιουργίας Kling 3.0.
Έλεγχος ταυτότητας
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Σώμα αιτήματος
{
"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
}
Παράδειγμα εικόνας σε βίντεο
{
"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"
}
Αναφορά πεδίου
prompt (συμβολοσειρά, απαιτείται, μέγιστο 2500)
GenerationMode (απαιτείται): text_to_video ή image_to_video
imageUrls (πίνακας): απαιτείται για τη μετάδοση εικόνας σε βίντεο, εκτός εάν παρέχονται διευθύνσεις URL πλαισίου
διάρκεια Δευτερόλεπτα (απαιτείται): ακέραιος 3..15
Λειτουργία ποιότητας (απαιτείται): std, pro, ή 4K
ήχος (προαιρετικό, boolean)
πολλαπλές λήψεις (προαιρετικό, boolean)
Αναλογία διαστάσεων (προαιρετικό): 16:9, 9:16, 1:1 (δεν επιτρέπεται όταν έχουν οριστεί διευθύνσεις URL πλαισίου έναρξης/λήξης)
startFrameUrl, endFrameUrl (προαιρετικά http(s) URL)
prompt_directory_optin (προαιρετικό, boolean): εφαρμόστε άμεση έκπτωση και αυτόματη κοινή χρήση στην επιτυχία
Απόκριση επιτυχίας
{
"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}/
Λήψη κατάστασης εργασίας και URL εξόδου όταν ολοκληρωθεί.
{
"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"
}
Τιμές κατάστασης: pending, processing, completed, failed.
Σε περίπτωση αποτυχίας, οι πιστώσεις επιστρέφονται αυτόματα.
/kling30/api/upload/
Μεταφορτώστε εικόνες πλαισίου πηγής/έναρξης/λήξης (JPEG/PNG/WebP, μέγιστο 10MB) και λάβετε μια δημόσια διεύθυνση URL για αιτήματα δημιουργίας.
Πίνακας τιμολόγησης (πιστώσεις ανά δευτερόλεπτο)
Πρότυπο
Χωρίς ήχο: 20 / s
Με ήχο: 30 / s
Pro
Χωρίς ήχο: 27 / s
Με ήχο: 40 / s
4Κ
67 / s
Παράδειγμα 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
}'
Κωδικοί σφαλμάτων
- 400 μη έγκυρο ωφέλιμο φορτίο
- 401 μη έγκυρος έλεγχος ταυτότητας
- 402 ανεπαρκείς πιστώσεις
- 429 ποσοστό περιορισμένο
- 500 ανάντη/παροχέα ή εσωτερική αποτυχία