الانتقال إلى المحتوى الرئيسي
GET
/
volc
/
v3
/
contents
/
generations
/
tasks
/
{id}
Query a ByteDance video task
curl --request GET \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "021773297205999example",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated.mp4"
  },
  "created_at": 1773297205,
  "updated_at": 1773297260,
  "resolution": "720p",
  "duration": 5,
  "ratio": "16:9",
  "framespersecond": 24
}
استخدم نقطة النهاية هذه بعد إنشاء مهمة ByteDance Jimeng. فهي لا تبدأ عملية render. بل تعرض فقط الحالة الحالية للمهمة، وعند اكتمال المهمة، تعرض رابط الفيديو المُنشأ وبيانات المخرجات الوصفية.

راقب هذه الحقول

  • status لمعرفة الحالة الحالية لدى المزوّد
  • content.video_url عند اكتمال عملية render
  • resolution وduration وratio وframespersecond إذا كان تطبيقك يحتاج إلى بيانات المخرجات الوصفية

حلقة Polling

1

أنشئ مهمة أولاً

2

استعلم باستخدام task id

واصل استدعاء نقطة النهاية هذه حتى تصل الحالة إلى حالة نهائية.
3

احفظ النتيجة

عندما يظهر content.video_url، انسخ النتيجة إلى التخزين الخاص بك إذا كنت بحاجة إلى الاحتفاظ بها لمدة طويلة.

روابط النتائج

لا تزال آلية عمل ByteDance تعتمد على الإنشاء أولاً، ثم الاستعلام باستخدام task id. يحافظ CometAPI على هذه البنية ويوحّد المصادقة. تعامل مع رابط الفيديو المُعاد على أنه رابط تسليم، وليس تخزينًا دائمًا.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

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

id
string
مطلوب

Task id returned by the create endpoint.

الاستجابة

200 - application/json

Current task state.

id
string
مطلوب
model
string
مطلوب
status
string
مطلوب

Provider task status.

created_at
integer
مطلوب
updated_at
integer
مطلوب
content
object
usage
object
seed
integer
resolution
string
duration
integer
ratio
string
framespersecond
integer