Maak een HappyHorse-video

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
}

{}

{}

Gebruik dit endpoint om een HappyHorse-videotaak te maken. De API retourneert onmiddellijk een taak-ID, dus sla de geretourneerde id op en poll de taak totdat deze een terminale status bereikt. POST /v1/videos gebruikt multipart/form-data; geef scalaire instellingen door als formuliervelden en referentieafbeeldingen als input_reference-bestandsvelden.

Kies een invoermodus

Doel	Model	Verplichte velden	Optionele velden
Tekst-naar-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referentie-naar-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, één `input_reference`-bestand	`seconds`, `size`, meer referentieafbeeldingen

Voor referentie-naar-video upload je 1-9 referentieafbeeldingen door het multipart-veld input_reference te herhalen. CometAPI verstuurt elk geüpload bestand als een HappyHorse-referentieafbeelding. Gebruik JPEG-, JPG-, PNG- of WEBP-afbeeldingen tot 20 MB per stuk; gebruik voor de beste resultaten afbeeldingen met een kortste zijde van minimaal 400 px.

Stel duur en grootte in

Model ID	`seconds`	Standaard
`happyhorse-1.0`	geheel getal `3`-`15`	`5` seconden, `1920x1080`
`happyhorse-1.1`	geheel getal `3`-`15`	`5` seconden, `1920x1080`

Stel size in op een exacte WxH-waarde.

Model	Framevorm	`size`-waarden
`happyhorse-1.0`	Liggend	`1280x720`, `1920x1080`
	Staand	`720x1280`, `1080x1920`
	Vierkant	`1440x1440`
`happyhorse-1.1`	Liggend	`1280x720`, `1920x1080`
	Staand	`720x1280`, `1080x1920`
	Vierkant	`1440x1440`
	Klassiek liggend	`1440x1080`
	Klassiek staand	`720x960`, `1080x1440`
	Breed liggend	`2520x1080`
	Breed staand	`1080x2520`
	Bijna-vierkant liggend	`900x720`, `1350x1080`
	Bijna-vierkant staand	`720x900`, `1080x1350`

Taakverloop

Maak de taak

Verstuur het multipart-formulierverzoek en sla de geretourneerde id op.

Poll de taak

Roep Een HappyHorse-video ophalen aan totdat status completed, failed of error is.

Download het resultaat

Wanneer de taak completed is, roep je HappyHorse-video-inhoud ophalen aan om het MP4-bestand te downloaden.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data

model

enum<string>

vereist

HappyHorse model ID for this endpoint.

Beschikbare opties:

happyhorse-1.0,

happyhorse-1.1

Voorbeeld:

"happyhorse-1.1"

prompt

string

vereist

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

Voorbeeld:

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

Voorbeeld:

"3"

size

string

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

Voorbeeld:

"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

vereist

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

Voorbeeld:

"task_example"

object

string

vereist

Object type. Video tasks return video.

Voorbeeld:

"video"

model

string

vereist

Model ID used for the task.

Voorbeeld:

"happyhorse-1.1"

status

enum<string>

vereist

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

Beschikbare opties:

queued,

in_progress,

completed,

failed,

error

Voorbeeld:

"queued"

progress

integer

vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100

Voorbeeld:

0

created_at

integer

vereist

Task creation time as a Unix timestamp in seconds.

Voorbeeld:

1779938152

task_id

string

Compatibility alias for id when present.

Voorbeeld:

"task_example"

completed_at

integer

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

Voorbeeld:

1779938219

video_url

string

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

Voorbeeld:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Een Seedance-video ophalen

Een HappyHorse-video ophalen

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
}

{}

{}

Contentmoderatie

API-sleutels

Kies een invoermodus

Stel duur en grootte in

Taakverloop

Autorisaties

Body

Respons

​Kies een invoermodus

​Stel duur en grootte in

​Taakverloop

Autorisaties

Body

Respons

Kies een invoermodus

Stel duur en grootte in

Taakverloop