الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

استخدم وثائق نماذج الفيديو في CometAPI من خلال اختيار سير عمل المزود الذي يطابق نوع مهمتك. تنشئ معظم نقاط نهاية الفيديو مهام غير متزامنة، لذا احفظ معرّف المهمة واستخدم polling لاسترجاع النتائج. أضف callbacks فقط عندما توثّق الصفحة الخاصة بالنموذج دعم callback.

​
اختر Video API

إنشاء فيديو Sora

أنشئ مهام فيديو Sora.

استرجاع فيديو Sora

استعلم عن مهام فيديو Sora.

Runway من صورة إلى فيديو

أنشئ فيديوهات Runway من الصور.

Kling من نص إلى فيديو

أنشئ فيديوهات Kling من prompts نصية.

إنشاء Seedance

أنشئ مهام فيديو Seedance.

توليد فيديو xAI

أنشئ مهام فيديو xAI.

​
أنشئ مهمة فيديو واستخدم polling

استخدم model ID يدعم الفيديو من صفحة النماذج أو دليل النماذج. تنشئ الأمثلة أدناه مهمة فيديو باستخدام POST /v1/videos، ثم تستخدم polling على معرّف المهمة المُعاد حتى تصل المهمة إلى حالة نهائية.
تستخدم هذه الأمثلة العنصر النائب your-video-model-id. استبدله بـ model ID متاح للفيديو من صفحة النماذج أو دليل النماذج قبل تشغيل الطلب.
افتح Create وQuery لاستخدام بيئات API playgrounds ومخططات نقاط النهاية.
import os
import time
import requests

headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

create_response = requests.post(
    "https://api.cometapi.com/v1/videos",
    headers=headers,
    data={
        "model": "your-video-model-id",
        "prompt": "A calm camera move across a desk with a paper airplane",
    },
    timeout=30,
)
create_response.raise_for_status()
task = create_response.json()
task_id = task["id"]

terminal_statuses = {"completed", "failed", "error"}

while True:
    poll_response = requests.get(
        f"https://api.cometapi.com/v1/videos/{task_id}",
        headers=headers,
        timeout=30,
    )
    poll_response.raise_for_status()
    result = poll_response.json()
    print(result["status"], result.get("progress"))

    if result["status"] in terminal_statuses:
        print(result.get("video_url"))
        break

    time.sleep(10)

​
أمثلة على الاستجابة

يمكن أن تبدو استجابة الإنشاء الناجحة بهذا الشكل. خزّن معرّف المهمة قبل استخدام polling: 
{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "queued",
  "progress": 0,
  "created_at": 1779872000
}
يمكن أن تبدو استجابة polling الناجحة بهذا الشكل. يمكن أن تتضمن الاستجابات المكتملة video_url؛ وتستخدم بعض تنسيقات المزود حقول نتائج خاصة بالنموذج أو مسار محتوى الفيديو عندما يكون هذا المسار موثّقًا: 
{
  "id": "task_example",
  "object": "video",
  "model": "your-video-model-id",
  "status": "completed",
  "progress": 100,
  "completed_at": 1779872300,
  "video_url": "https://example.com/generated-video.mp4"
}

​
أمثلة على سجلات النماذج

يوضح هذا المثال لاستجابة فهرس النماذج غلاف /api/models وشكل سجل واحد لنموذج فيديو. وهو ليس قائمة نماذج كاملة.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1767529753,
      "id": "your-video-model-id",
      "code": "your-video-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example video model",
      "model_type": "video",
      "features": [
        "text-to-video"
      ],
      "endpoints": "{\n  \"seedance\": {\n    \"path\": \"/v1/videos\",\n    \"method\": \"POST\"\n  }\n}",
      "pricing": {
        "currency": "USD / M Tokens",
        "input": null,
        "output": null,
        "per_request": null,
        "per_second": 0.024
      }
    }
  ]
}

​
الأخطاء الشائعة

خزّن المعرّف من استجابة الإنشاء قبل الرجوع من معالج المهمة.
أضف تأخيرًا وتراجعًا تدريجيًا بين عمليات التحقق من الحالة.
استخدم حقول المدة والدقة الموثّقة لنقطة نهاية الفيديو المحددة.
تعامل مع video_url على أنه اختياري، واستخدم حقول النتائج الخاصة بالنموذج أو مسار المحتوى عند توفره.
استخدم polling بوصفه المصدر الأساسي للحقيقة، وتحقق من أن عنوان URL الخاص بـ callback لديك يقبل طلبات POST.

​
رموز الأخطاء واستراتيجية إعادة المحاولة

لا تُعد المحاولة حتى يتم إصلاح حقول prompt أو الملفات أو المدة أو الحجم.
لا تُعد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
تحقّق من معرّف المهمة، وBase URL، والمسار، وmodel ID قبل إعادة المحاولة.
قلّل حجم الرفع قبل إعادة المحاولة.
أعد المحاولة باستخدام exponential backoff وقلّل التوازي في الإنشاء أو polling.
أعد محاولة إنشاء المهمة مع backoff؛ واستمر في polling للمهام الموجودة ما لم تصل المهمة إلى خطأ نهائي.
للاطلاع على أنماط التنفيذ، راجع Error codes and retry strategy وRate limits and concurrency وWebhook and polling for video generation.

​
التسعير ودليل النماذج

صفحة النماذج

اقرأ كيف يوفّر CometAPI model IDs في الوثائق.

دليل النماذج

تصفح توفر النماذج وإمكاناتها.

التسعير

تحقّق من التسعير قبل استدعاء أي نموذج.
Last modified on May 28, 2026