Membuat video 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
}

{}

{}

Gunakan endpoint ini untuk membuat tugas video HappyHorse. API segera mengembalikan task ID, jadi simpan id yang dikembalikan dan lakukan polling pada tugas hingga mencapai status terminal. POST /v1/videos menggunakan multipart/form-data; kirim kontrol skalar sebagai form field dan gambar referensi sebagai input_reference file field.

Pilih mode input

Tujuan	Model	Field wajib	Field opsional
Teks-ke-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referensi-ke-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, satu file `input_reference`	`seconds`, `size`, lebih banyak gambar referensi

Untuk referensi-ke-video, unggah 1-9 gambar referensi dengan mengulangi multipart field input_reference. CometAPI mengirim setiap file yang diunggah sebagai gambar referensi HappyHorse. Gunakan gambar JPEG, JPG, PNG, atau WEBP hingga 20 MB per gambar; untuk hasil terbaik, gunakan gambar dengan sisi terpendek setidaknya 400 px.

Atur durasi dan ukuran

Model ID	`seconds`	Default
`happyhorse-1.0`	integer `3`-`15`	`5` detik, `1920x1080`
`happyhorse-1.1`	integer `3`-`15`	`5` detik, `1920x1080`

Atur size ke nilai WxH yang tepat.

Model	Bentuk frame	Nilai `size`
`happyhorse-1.0`	Lanskap	`1280x720`, `1920x1080`
	Potret	`720x1280`, `1080x1920`
	Persegi	`1440x1440`
`happyhorse-1.1`	Lanskap	`1280x720`, `1920x1080`
	Potret	`720x1280`, `1080x1920`
	Persegi	`1440x1440`
	Lanskap klasik	`1440x1080`
	Potret klasik	`720x960`, `1080x1440`
	Lanskap lebar	`2520x1080`
	Potret lebar	`1080x2520`
	Lanskap hampir persegi	`900x720`, `1350x1080`
	Potret hampir persegi	`720x900`, `1080x1350`

Alur tugas

Buat tugas

Kirim permintaan form multipart dan simpan id yang dikembalikan.

Polling tugas

Panggil Retrieve a HappyHorse video hingga status bernilai completed, failed, atau error.

Unduh hasil

Saat tugas berstatus completed, panggil Retrieve HappyHorse video content untuk mengunduh file MP4.

Otorisasi

Authorization

string

header

wajib

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data

model

enum<string>

wajib

HappyHorse model ID for this endpoint.

Opsi yang tersedia:

happyhorse-1.0,

happyhorse-1.1

Contoh:

"happyhorse-1.1"

prompt

string

wajib

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

Contoh:

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

Contoh:

"3"

size

string

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

Contoh:

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

Respons

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

string

wajib

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

Contoh:

"task_example"

object

string

wajib

Object type. Video tasks return video.

Contoh:

"video"

model

string

wajib

Model ID used for the task.

Contoh:

"happyhorse-1.1"

status

enum<string>

wajib

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

Opsi yang tersedia:

queued,

in_progress,

completed,

failed,

error

Contoh:

"queued"

progress

integer

wajib

Task progress as a coarse percentage.

Rentang yang diperlukan: 0 <= x <= 100

Contoh:

0

created_at

integer

wajib

Task creation time as a Unix timestamp in seconds.

Contoh:

1779938152

task_id

string

Compatibility alias for id when present.

Contoh:

"task_example"

completed_at

integer

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

Contoh:

1779938219

video_url

string

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

Contoh:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Mengambil video Seedance

Sebelumnya

Mengambil video HappyHorse

Selanjutnya

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
}

{}

{}

Moderasi konten

Kunci API

Pilih mode input

Atur durasi dan ukuran

Alur tugas

Otorisasi

Body

Respons

​Pilih mode input

​Atur durasi dan ukuran

​Alur tugas

Otorisasi

Body

Respons

Pilih mode input

Atur durasi dan ukuran

Alur tugas