Crea un 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
}

Crea un video HappyHorse da testo, immagini di riferimento o un fotogramma iniziale. L’API restituisce immediatamente un ID attività. Salva il valore id restituito per eseguire il polling dell’attività e scaricare il video completato. POST /v1/videos utilizza multipart/form-data. Invia i controlli come campi del modulo e le immagini di riferimento come campi input_reference, con un URL HTTPS o un file immagine caricato per campo.

Scegli una modalità di input

Obiettivo	Modello	Campi obbligatori	Campi facoltativi
Da testo a video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Da riferimento a video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, 1–9 `input_reference` URL o file	`seconds`, `size`
Da immagine del primo fotogramma a video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, un URL o file `first_frame`	`seconds`, `size`

Le immagini di riferimento guidano i soggetti e i dettagli visivi nel video. Invia da 1 a 9 URL HTTPS di immagini pubblicamente accessibili oppure da 1 a 9 file immagine, ripetendo input_reference una volta per immagine nell’ordine delle immagini. Utilizza solo URL o solo file all’interno di questo campo. Invia ogni URL separatamente anziché unire gli URL con virgole. Per input_reference, ogni immagine di riferimento deve avere dimensioni pari o inferiori a 10 MB con happyhorse-1.0. Con happyhorse-1.1, ogni immagine di riferimento deve avere dimensioni pari o inferiori a 20 MB. Questi limiti del modello si applicano sia agli URL delle immagini sia ai file caricati. Utilizza immagini JPEG, JPG, PNG o WEBP con un lato più corto di almeno 400 px. Il limite di caricamento input_reference è di 20 MiB (20 × 1024 × 1024 byte) per file. Le immagini caricate devono inoltre rispettare il limite specifico del modello indicato sopra. Gli esempi di richieste all’inizio di questa pagina mostrano più URL di immagini per HappyHorse 1.1 e più caricamenti di file per entrambi i modelli. Per impostare il fotogramma iniziale, invia first_frame una volta con un URL HTTPS di immagine pubblicamente accessibile o un file immagine. Utilizza questo campo in una richiesta separata da input_reference.

Imposta durata e dimensioni

ID modello	`seconds`	Predefinito
`happyhorse-1.0`	intero `3`-`15`	`5` secondi, `1920x1080`
`happyhorse-1.1`	intero `3`-`15`	`5` secondi, `1920x1080`

Scegli un valore WxH esatto per size dalla tabella seguente. Per le richieste con primo fotogramma, l’immagine determina l’inquadratura e le proporzioni, mentre size seleziona il livello di risoluzione dell’output.

Modello	Formato del fotogramma	`size` valori
`happyhorse-1.0`	Orizzontale	`1280x720`, `1920x1080`
	Verticale	`720x1280`, `1080x1920`
	Quadrato	`1440x1440`
`happyhorse-1.1`	Orizzontale	`1280x720`, `1920x1080`
	Verticale	`720x1280`, `1080x1920`
	Quadrato	`1440x1440`
	Orizzontale classico	`1440x1080`
	Verticale classico	`720x960`, `1080x1440`
	Orizzontale panoramico	`2520x1080`
	Verticale panoramico	`1080x2520`
	Orizzontale quasi quadrato	`900x720`, `1350x1080`
	Verticale quasi quadrato	`720x900`, `1080x1350`

Flusso dell’attività

Crea l'attività

Invia la richiesta del modulo multipart e salva il valore id restituito.

Esegui il polling dell'attività

Chiama Recupera un video HappyHorse finché status non è completed, failed o error.

Scarica il risultato

Quando l’attività è completed, chiama Recupera il contenuto del video HappyHorse per scaricare il file MP4.

Autorizzazioni

Authorization

string

header

obbligatorio

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

enum<string>

obbligatorio

HappyHorse model ID for this endpoint.

Opzioni disponibili:

happyhorse-1.0,

happyhorse-1.1

Esempio:

"happyhorse-1.1"

prompt

string

obbligatorio

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

Esempio:

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

seconds

integer

predefinito:5

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

Intervallo richiesto: 3 <= x <= 15

Esempio:

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.

Esempio:

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

Risposta

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

string

obbligatorio

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

Esempio:

"task_example"

object

string

obbligatorio

Object type. Video tasks return video.

Esempio:

"video"

model

string

obbligatorio

Model ID used for the task.

Esempio:

"happyhorse-1.1"

status

enum<string>

obbligatorio

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

Opzioni disponibili:

queued,

in_progress,

completed,

failed,

error

Esempio:

"queued"

progress

integer

obbligatorio

Task progress as a coarse percentage.

Intervallo richiesto: 0 <= x <= 100

Esempio:

0

created_at

integer

obbligatorio

Task creation time as a Unix timestamp in seconds.

Esempio:

1779938152

task_id

string

Compatibility alias for id when present.

Esempio:

"task_example"

completed_at

integer

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

Esempio:

1779938219

video_url

string

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

Esempio:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Ultima modifica il 9 settembre 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
}

Moderazione dei contenuti

Chiavi API

Scegli una modalità di input

Imposta durata e dimensioni

Flusso dell’attività

Autorizzazioni

Corpo

Risposta

​Scegli una modalità di input

​Imposta durata e dimensioni

​Flusso dell’attività

Autorizzazioni

Corpo

Risposta

Scegli una modalità di input

Imposta durata e dimensioni

Flusso dell’attività