Een HappyHorse-video maken

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
}

Maak een HappyHorse-video van tekst, referentieafbeeldingen of een openingsframe. De API retourneert onmiddellijk een taak-ID. Sla de geretourneerde id op om de taakstatus op te vragen en de voltooide video te downloaden. POST /v1/videos gebruikt multipart/form-data. Verzend instellingen als formuliervelden en referentieafbeeldingen als input_reference-velden, met één HTTPS-URL of geüpload afbeeldingsbestand per veld.

Een invoermodus kiezen

Doel	Model	Vereiste 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`, 1–9 `input_reference` URL’s of bestanden	`seconds`, `size`
Afbeelding-naar-video met eerste frame	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, één `first_frame`-URL of bestand	`seconds`, `size`

Referentieafbeeldingen sturen de onderwerpen en visuele details in de video. Verzend 1–9 openbaar toegankelijke HTTPS-afbeeldings-URL’s of 1–9 afbeeldingsbestanden, waarbij je input_reference één keer per afbeelding herhaalt in afbeeldingsvolgorde. Gebruik binnen dit veld alleen URL’s of alleen bestanden. Verzend elke URL afzonderlijk in plaats van URL’s met komma’s te verbinden. Voor input_reference mag elke referentieafbeelding maximaal 10 MB zijn met happyhorse-1.0. Met happyhorse-1.1 mag elke referentieafbeelding maximaal 20 MB zijn. Deze modellimieten gelden zowel voor afbeeldings-URL’s als voor geüploade bestanden. Gebruik JPEG-, JPG-, PNG- of WEBP-afbeeldingen met een kortste zijde van minstens 400 px. De uploadlimiet voor input_reference is 20 MiB (20 × 1024 × 1024 bytes) per bestand. Geüploade afbeeldingen moeten ook voldoen aan de bovenstaande modelspecifieke limiet. De aanvraagvoorbeelden bovenaan deze pagina tonen meerdere afbeeldings-URL’s voor HappyHorse 1.1 en meerdere bestandsuploads voor beide modellen. Verzend first_frame één keer met één openbaar toegankelijke HTTPS-afbeeldings-URL of één afbeeldingsbestand om het openingsframe in te stellen. Gebruik dit veld in een afzonderlijke aanvraag van input_reference.

Duur en grootte instellen

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

Kies uit de onderstaande tabel een exacte WxH-waarde voor size. Voor aanvragen met een eerste frame bepaalt de afbeelding de kadrering en beeldverhouding, terwijl size de uitvoerresolutieklasse selecteert.

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`

Taakstroom

De taak maken

Verzend de multipart-formulieraanvraag en sla de geretourneerde id op.

De taakstatus opvragen

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

Het resultaat downloaden

Wanneer de taak completed is, roep 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 image inputs, describe the motion and visual details to preserve.

Voorbeeld:

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

seconds

integer

standaard:5

Requested clip duration in whole seconds. Send an integer from 3 through 15 as a form field. The default is 5.

Vereist bereik: 3 <= x <= 15

Voorbeeld:

3

size

string

Output size as an exact WxH value. Use one of the documented size values for the selected HappyHorse model. For first-frame requests, size selects the resolution tier; the image determines the framing and aspect ratio.

Voorbeeld:

"1920x1080"

input_reference

Reference images for reference-to-video. Send 1–9 publicly accessible HTTPS image URLs or 1–9 uploaded image files by repeating input_reference once per image. Use only URLs or only files within this field; do not join URLs with commas. Reference images guide subjects and visual details. CometAPI preserves image order. Use JPEG, JPG, PNG, or WEBP images with a shortest side of at least 400 px. Each reference image must be at or below 10 MB for happyhorse-1.0 or 20 MB for happyhorse-1.1. These model limits apply to both image URLs and uploaded files. The input_reference file upload limit is 20 MiB (20 x 1024 x 1024 bytes) per file. Keep uploads within the model limit as well. Keep this field separate from first_frame.

Pattern: ^https://

first_frame

Opening-frame image as one publicly accessible HTTPS URL or one image file. Send this field once, using either a URL or a file. Use JPEG, JPG, PNG, or WEBP images up to 20 MB. Do not combine first_frame with input_reference.

Pattern: ^https://

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.

Laatst gewijzigd op 9 september 2026

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

Een invoermodus kiezen

Duur en grootte instellen

Taakstroom

Autorisaties

Body

Respons

​Een invoermodus kiezen

​Duur en grootte instellen

​Taakstroom

Autorisaties

Body

Respons

Een invoermodus kiezen

Duur en grootte instellen

Taakstroom