إنشاء فيديو HappyHorse

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

استخدم نقطة النهاية هذه لإنشاء مهمة فيديو HappyHorse. تعيد واجهة API معرّف المهمة فورًا، لذا خزّن قيمة id المُعادة واستعلم عن المهمة بشكل متكرر حتى تصل إلى حالة نهائية. يستخدم POST /v1/videos النوع multipart/form-data؛ مرّر عناصر التحكم القيمية كحقول form والصور المرجعية كحقول ملفات input_reference.

اختر وضع الإدخال

الهدف	الموديل	الحقول المطلوبة	الحقول الاختيارية
من النص إلى الفيديو	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
من المرجع إلى الفيديو	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, ملف `input_reference` واحد	`seconds`, `size`, المزيد من الصور المرجعية

في وضع من المرجع إلى الفيديو، ارفع من 1 إلى 9 صور مرجعية عبر تكرار حقل multipart input_reference. ترسل CometAPI كل ملف مرفوع كصورة مرجعية لـ HappyHorse. استخدم صور JPEG أو JPG أو PNG أو WEBP بحجم يصل إلى 20 ميجابايت لكل صورة؛ ولأفضل النتائج، استخدم صورًا يكون أقصر ضلع فيها 400 px على الأقل.

اضبط المدة والحجم

Model ID	`seconds`	الافتراضي
`happyhorse-1.0`	عدد صحيح من `3` إلى `15`	`5` ثوانٍ، `1920x1080`
`happyhorse-1.1`	عدد صحيح من `3` إلى `15`	`5` ثوانٍ، `1920x1080`

اضبط size على قيمة WxH دقيقة.

الموديل	شكل الإطار	قيم `size`
`happyhorse-1.0`	أفقي	`1280x720`, `1920x1080`
	عمودي	`720x1280`, `1080x1920`
	مربع	`1440x1440`
`happyhorse-1.1`	أفقي	`1280x720`, `1920x1080`
	عمودي	`720x1280`, `1080x1920`
	مربع	`1440x1440`
	أفقي كلاسيكي	`1440x1080`
	عمودي كلاسيكي	`720x960`, `1080x1440`
	أفقي عريض	`2520x1080`
	عمودي عريض	`1080x2520`
	أفقي شبه مربع	`900x720`, `1350x1080`
	عمودي شبه مربع	`720x900`, `1080x1350`

سير المهمة

إنشاء المهمة

أرسل طلب multipart form وخزّن قيمة id المُعادة.

الاستعلام عن المهمة

استدعِ استرجاع فيديو HappyHorse حتى تصبح قيمة status هي completed أو failed أو error.

تنزيل النتيجة

عندما تكون المهمة في حالة completed، استدعِ استرجاع محتوى فيديو HappyHorse لتنزيل ملف MP4.

التفويضات

Authorization

string

header

مطلوب

Bearer authentication. Use your CometAPI API key.

الجسم

multipart/form-data

model

enum<string>

مطلوب

HappyHorse model ID for this endpoint.

الخيارات المتاحة:

happyhorse-1.0,

happyhorse-1.1

مثال:

"happyhorse-1.1"

prompt

string

مطلوب

Text prompt that describes the video to generate. For reference-image requests, combine the prompt with the uploaded reference image.

مثال:

"Use the uploaded reference image as the visual guide. Create a short cinematic shot with gentle natural motion."

seconds

string

Requested clip duration in seconds. Use an integer from 3 through 15. Default is 5.

مثال:

"3"

size

string

Output size as an exact WxH value. Use one of the documented size values for the selected HappyHorse model.

مثال:

"1920x1080"

input_reference

file

Reference image file for reference-to-video. Required when using reference-to-video; repeat this multipart field to send additional reference images. CometAPI preserves upload order. Use JPEG, JPG, PNG, or WEBP images up to 20 MB each.

الاستجابة

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

مطلوب

Task ID. Use this value with retrieve and content endpoints.

مثال:

"task_example"

object

string

مطلوب

Object type. Video tasks return video.

مثال:

"video"

model

string

مطلوب

Model ID used for the task.

مثال:

"happyhorse-1.1"

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 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.

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

استرداد فيديو HappyHorse

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=happyhorse-1.1 \
  -F 'prompt=A close-up cinematic shot of a ceramic coffee cup on a wooden table. Steam rises slowly while morning light moves across the background.' \
  -F seconds=3 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "happyhorse-1.1",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

{}

{}

الإشراف على المحتوى

مفاتيح API

اختر وضع الإدخال

اضبط المدة والحجم

سير المهمة

التفويضات

الجسم

الاستجابة

​اختر وضع الإدخال

​اضبط المدة والحجم

​سير المهمة

التفويضات

الجسم

الاستجابة

اختر وضع الإدخال

اضبط المدة والحجم

سير المهمة