الانتقال إلى المحتوى الرئيسي
GET
/
kling
/
v1
/
{action}
/
{action2}
/
{task_id}
Individual queries
curl --request GET \
  --url https://api.cometapi.com/kling/v1/{action}/{action2}/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "task_info": {
      "parent_video": {
        "id": "<string>",
        "url": "<string>",
        "duration": "<string>"
      }
    },
    "task_result": {
      "videos": [
        {
          "id": "<string>",
          "url": "<string>",
          "duration": "<string>"
        }
      ]
    },
    "created_at": 123,
    "updated_at": 123
  }
}
استخدم هذه المجموعة من نقاط النهاية بعد إنشاء مهمة Kling. وهي خطوة polling الشائعة لمهام الوسائط غير المتزامنة في Kling.

ما الذي يجب التحقق منه أولًا

  • حالة المهمة أو حقول تقدّم المهمة التي يعيدها الغلاف
  • البيانات الوصفية للمخرجات أو عناوين URL للأصول عند اكتمال المهمة
  • رسائل الفشل الخاصة بالمزوّد عندما تتوقف المهمة مبكرًا

نمط polling

1

أنشئ المهمة من نقطة النهاية المطابقة

ابدأ من صفحة إنشاء Kling المناسبة لسير عملك، مثل Text to Video أو Image to Video.
2

استعلم حتى تصل المهمة إلى حالة نهائية

استمر في الاستعلام باستخدام task id المُعاد حتى تصل الحالة إلى success أو failure.
3

تابع إلى الخطوة التالية في سير العمل

استخدم المخرجات المكتملة مباشرة، أو انتقل إلى صفحة الإجراء التالية الخاصة بالمزوّد إذا كان سير عملك يدعم العمليات المتسلسلة.
للاطلاع على المرجع الكامل للمعلمات، راجع وثائق Kling الرسمية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

معلمات المسار

action
string
مطلوب

Resource type. One of: images, videos, audio.

action2
string
مطلوب

Sub-action matching the resource type. For images: generations, kolors-virtual-try-on. For videos: text2video, image2video, lip-sync, effects, multi-image2video, multi-elements. For audio: text-to-audio, video-to-audio.

task_id
string
مطلوب

Task ID

الاستجابة

200 - application/json

Successful Response

code
integer
مطلوب

Return code

message
string
مطلوب

Text description of the request result

request_id
string
مطلوب

Unique identifier for this request

data
object
مطلوب

Object containing specific response data