Μετάβαση στο περιεχόμενο

Έγγραφα προγραμματιστή 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 ανάντη/παροχέα ή εσωτερική αποτυχία

Πιστώσεις, μοντέλα και κατάσταση