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

​

آلة الحالات

​

وتيرة الاستعلام

import time
import requests

TASK_ID = "<TASK_ID>"
headers = {"Authorization": "Bearer <COMETAPI_KEY>"}
TERMINAL = {"SUCCESS", "FAILED", "ERROR"}

while True:
    response = requests.get(
        f"https://api.cometapi.com/v1/videos/{TASK_ID}",
        headers=headers,
        timeout=15,
    )
    response.raise_for_status()
    data = response.json()
    if data["status"] in TERMINAL:
        print(data.get("video_url"))
        break
    time.sleep(10)

​

الحقول التي يجب متابعتها

• status — يحدد شرط الإيقاف في حلقة الاستعلام لديك.
• progress — عدد صحيح من 0 إلى 100 يمكنك عرضه في واجهة المستخدم.
• video_url — عنوان URL موقّع للتنزيل، ويكون موجودًا فقط عند SUCCESS. التوقيع محدود زمنيًا؛ نزّل الملف أو أعد استضافته قبل انتهاء صلاحية التوقيع.
• completed_at — طابع زمني Unix يتم تعبئته بمجرد وصول المهمة إلى حالة نهائية.
• model — يعكس model ID الخاص بـ Seedance المستخدم عند إنشاء المهمة.

​

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

• يشير HTTP 400 مع message: "task_not_exist" إلى أن id غير معروف. تأكد من أنك التقطت id من استجابة POST /v1/videos ناجحة وأنك تستخدمه كما هو حرفيًا.
• يشير HTTP 401 إلى أن bearer token مفقود أو غير صالح. تحقق من أن ترويسة الطلب هي Authorization: Bearer <COMETAPI_KEY>.