Bir HappyHorse videosu oluşturun

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
}

{}

{}

Bu endpoint’i bir HappyHorse video görevi oluşturmak için kullanın. API hemen bir görev kimliği döndürür, bu nedenle döndürülen id değerini saklayın ve terminal duruma ulaşana kadar görevi sorgulayın. POST /v1/videos, multipart/form-data kullanır; skaler kontrolleri form alanları olarak ve referans görselleri input_reference dosya alanları olarak iletin.

Bir giriş modu seçin

Amaç	Model	Gerekli alanlar	İsteğe bağlı alanlar
Metinden videoya	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referanstan videoya	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, bir `input_reference` dosyası	`seconds`, `size`, daha fazla referans görsel

Referanstan videoya için, input_reference multipart alanını tekrarlayarak 1-9 referans görsel yükleyin. CometAPI yüklenen her dosyayı bir HappyHorse referans görseli olarak gönderir. Her biri en fazla 20 MB olan JPEG, JPG, PNG veya WEBP görseller kullanın; en iyi sonuçlar için en kısa kenarı en az 400 px olan görseller kullanın.

Süreyi ve boyutu ayarlayın

Model ID	`seconds`	Varsayılan
`happyhorse-1.0`	tamsayı `3`-`15`	`5` saniye, `1920x1080`
`happyhorse-1.1`	tamsayı `3`-`15`	`5` saniye, `1920x1080`

size değerini tam bir WxH değeri olarak ayarlayın.

Model	Kare biçimi	`size` değerleri
`happyhorse-1.0`	Yatay	`1280x720`, `1920x1080`
	Dikey	`720x1280`, `1080x1920`
	Kare	`1440x1440`
`happyhorse-1.1`	Yatay	`1280x720`, `1920x1080`
	Dikey	`720x1280`, `1080x1920`
	Kare	`1440x1440`
	Klasik yatay	`1440x1080`
	Klasik dikey	`720x960`, `1080x1440`
	Geniş yatay	`2520x1080`
	Geniş dikey	`1080x2520`
	Neredeyse kare yatay	`900x720`, `1350x1080`
	Neredeyse kare dikey	`720x900`, `1080x1350`

Görev akışı

Görevi oluşturun

Multipart form isteğini gönderin ve döndürülen id değerini saklayın.

Görevi sorgulayın

status, completed, failed veya error olana kadar Bir HappyHorse videosunu alın çağrısını yapın.

Sonucu indirin

Görev completed olduğunda, MP4 dosyasını indirmek için HappyHorse video içeriğini alın çağrısını yapın.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data

model

enum<string>

gerekli

HappyHorse model ID for this endpoint.

Mevcut seçenekler:

happyhorse-1.0,

happyhorse-1.1

Örnek:

"happyhorse-1.1"

prompt

string

gerekli

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

Örnek:

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

Örnek:

"3"

size

string

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

Örnek:

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

Yanıt

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

string

gerekli

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

Örnek:

"task_example"

object

string

gerekli

Object type. Video tasks return video.

Örnek:

"video"

model

string

gerekli

Model ID used for the task.

Örnek:

"happyhorse-1.1"

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed,

error

Örnek:

"queued"

progress

integer

gerekli

Task progress as a coarse percentage.

Gerekli aralık: 0 <= x <= 100

Örnek:

0

created_at

integer

gerekli

Task creation time as a Unix timestamp in seconds.

Örnek:

1779938152

task_id

string

Compatibility alias for id when present.

Örnek:

"task_example"

completed_at

integer

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

Örnek:

1779938219

video_url

string

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

Örnek:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Bir Seedance videosunu getir

Bir HappyHorse videosunu alın

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
}

{}

{}

İçerik moderasyonu

API anahtarları

Bir giriş modu seçin

Süreyi ve boyutu ayarlayın

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Bir giriş modu seçin

​Süreyi ve boyutu ayarlayın

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Bir giriş modu seçin

Süreyi ve boyutu ayarlayın

Görev akışı