مستندات المطور 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 ثانية
جودة قياسية أو احترافية أو 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
valueMode (مطلوب): std, proأو 4K
صوت (اختياري، منطقي)
لقطات متعددة (اختياري، منطقي)
نسبة العرض إلى الارتفاع (اختياري): 16:9, 9:16, 1:1 (غير مسموح به عند تعيين عناوين URL لإطار البداية/النهاية)
startFrameUrl, endFrameUrl (عناوين URL الاختيارية لـ http(s))
prompt_directory_optin (اختياري، منطقي): تطبيق الخصم الفوري والمشاركة التلقائية عند النجاح
استجابة النجاح
{
"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، بحد أقصى 10 ميجابايت) واحصل على عنوان URL عام لطلبات الإنشاء.
مصفوفة التسعير (اعتمادات في الثانية)
معيار
لا يوجد صوت: 20 / ق
مع الصوت: 30 / ق
برو
لا يوجد صوت: 27 / ق
مع الصوت: 40 / ق
4K
67 / ق
مثال الضفيرة
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 المنبع/المزود أو الفشل الداخلي