Opprett en 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
}

Opprett en HappyHorse-video fra tekst, referansebilder eller et startbilde. API-et returnerer umiddelbart en oppgave-ID. Lagre den returnerte id for å kontrollere oppgaven regelmessig og laste ned den fullførte videoen. POST /v1/videos bruker multipart/form-data. Send kontroller som skjemafelt og referansebilder som input_reference-felt, med én HTTPS-URL eller opplastet bildefil per felt.

Velg en inndatamodus

Formål	Modell	Obligatoriske felt	Valgfrie felt
Tekst-til-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referanse-til-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, 1–9 `input_reference` URL-er eller filer	`seconds`, `size`
Bilde-til-video med første bilde	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, én `first_frame`-URL eller fil	`seconds`, `size`

Referansebilder styrer motivene og de visuelle detaljene i videoen. Send 1–9 offentlig tilgjengelige HTTPS-bilde-URL-er eller 1–9 bildefiler, og gjenta input_reference én gang per bilde i bilderekkefølge. Bruk enten bare URL-er eller bare filer i dette feltet. Send hver URL separat i stedet for å sette sammen URL-er med kommaer. For input_reference må hvert referansebilde være på maksimalt 10 MB med happyhorse-1.0. Med happyhorse-1.1 må hvert referansebilde være på maksimalt 20 MB. Disse modellgrensene gjelder både for bilde-URL-er og opplastede filer. Bruk JPEG-, JPG-, PNG- eller WEBP-bilder med en korteste side på minst 400 px. Opplastingsgrensen for input_reference er 20 MiB (20 × 1024 × 1024 byte) per fil. Opplastede bilder må også oppfylle den modellspesifikke grensen ovenfor. Forespørselseksemplene øverst på denne siden viser flere bilde-URL-er for HappyHorse 1.1 og flere filopplastinger for begge modellene. For å angi startbildet sender du first_frame én gang med én offentlig tilgjengelig HTTPS-bilde-URL eller én bildefil. Bruk dette feltet i en separat forespørsel fra input_reference.

Angi varighet og størrelse

Modell-ID	`seconds`	Standard
`happyhorse-1.0`	heltall `3`-`15`	`5` sekunder, `1920x1080`
`happyhorse-1.1`	heltall `3`-`15`	`5` sekunder, `1920x1080`

Velg en nøyaktig WxH-verdi for size fra tabellen nedenfor. For forespørsler med første bilde bestemmer bildet innrammingen og størrelsesforholdet, mens size velger oppløsningsnivået for utdataene.

Modell	Bildeformat	`size` verdier
`happyhorse-1.0`	Liggende	`1280x720`, `1920x1080`
	Stående	`720x1280`, `1080x1920`
	Kvadratisk	`1440x1440`
`happyhorse-1.1`	Liggende	`1280x720`, `1920x1080`
	Stående	`720x1280`, `1080x1920`
	Kvadratisk	`1440x1440`
	Klassisk liggende	`1440x1080`
	Klassisk stående	`720x960`, `1080x1440`
	Bredt liggende	`2520x1080`
	Bredt stående	`1080x2520`
	Nær kvadratisk liggende	`900x720`, `1350x1080`
	Nær kvadratisk stående	`720x900`, `1080x1350`

Oppgaveflyt

Opprett oppgaven

Send multipart-skjemaforespørselen og lagre den returnerte id.

Kontroller oppgaven regelmessig

Kall Hent en HappyHorse-video til status er completed, failed eller error.

Last ned resultatet

Når oppgaven er completed, kaller du Hent HappyHorse-videoinnhold for å laste ned MP4-filen.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

multipart/form-data

model

enum<string>

påkrevd

HappyHorse model ID for this endpoint.

Tilgjengelige alternativer:

happyhorse-1.0,

happyhorse-1.1

Eksempel:

"happyhorse-1.1"

prompt

string

påkrevd

Text prompt that describes the video to generate. For image inputs, describe the motion and visual details to preserve.

Eksempel:

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

seconds

integer

standard:5

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

Nødvendig område: 3 <= x <= 15

Eksempel:

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.

Eksempel:

"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://

Svar

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

string

påkrevd

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

Eksempel:

"task_example"

object

string

påkrevd

Object type. Video tasks return video.

Eksempel:

"video"

model

string

påkrevd

Model ID used for the task.

Eksempel:

"happyhorse-1.1"

status

enum<string>

påkrevd

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

Tilgjengelige alternativer:

queued,

in_progress,

completed,

failed,

error

Eksempel:

"queued"

progress

integer

påkrevd

Task progress as a coarse percentage.

Nødvendig område: 0 <= x <= 100

Eksempel:

0

created_at

integer

påkrevd

Task creation time as a Unix timestamp in seconds.

Eksempel:

1779938152

task_id

string

Compatibility alias for id when present.

Eksempel:

"task_example"

completed_at

integer

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

Eksempel:

1779938219

video_url

string

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

Eksempel:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Sist endret 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
}

Innholdsmoderering

API-nøkler

Velg en inndatamodus

Angi varighet og størrelse

Oppgaveflyt

Autorisasjoner

Kropp

Svar

​Velg en inndatamodus

​Angi varighet og størrelse

​Oppgaveflyt

Autorisasjoner

Kropp

Svar

Velg en inndatamodus

Angi varighet og størrelse

Oppgaveflyt