Skip to main content
GET
cURL
استخدم نقطة النهاية هذه بعد إنشاء مهمة فيديو HappyHorse. فهي تعرض حالة المهمة وتتضمن video_url بعد اكتمال المهمة.

تحقق من هذه الحقول

  • يوضح status ما إذا كانت المهمة queued أو in_progress أو completed أو failed أو error.
  • يمثّل progress نسبة مئوية تقريبية للاكتمال.
  • يظهر video_url في الاستجابات المكتملة.
  • يظهر error عند فشل المهمة.

تدفق Polling

1

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

ابدأ من إنشاء فيديو HappyHorse واحتفِظ بالقيمة id المُعادة.
2

استعلم باستخدام معرّف المهمة

أرسل معرّف المهمة إلى نقطة النهاية هذه حتى تصل قيمة status إلى completed أو failed أو error.
3

نزّل ملف MP4

عندما تكون قيمة status هي completed، استدعِ استرداد محتوى فيديو HappyHorse.

التفويضات

Authorization
string
header
مطلوب

Bearer authentication. Use your CometAPI API key.

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

task_id
string
مطلوب

Task ID returned by POST /v1/videos.

الاستجابة

Current HappyHorse video task state.

id
string
مطلوب

Task ID. Use this value as task_id in retrieve and content requests.

مثال:

"task_example"

object
string
مطلوب

Object type. HappyHorse video tasks return video.

مثال:

"video"

model
string
مطلوب

Model ID used for the task.

مثال:

"happyhorse-1.0"

status
enum<string>
مطلوب

Task lifecycle status. Poll until the value is completed, failed, or error.

الخيارات المتاحة:
queued,
in_progress,
completed,
failed,
error
مثال:

"queued"

progress
integer
مطلوب

Task progress as a coarse percentage.

النطاق المطلوب: 0 <= x <= 100
مثال:

0

created_at
integer
مطلوب

Task creation time as a Unix timestamp in seconds.

مثال:

1779938152

task_id
string

Compatibility alias for id. The value matches id when present.

مثال:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

مثال:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

مثال:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.