الانتقال إلى المحتوى الرئيسي
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

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

ابدأ من ByteDance Video Generation.
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