Creare 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
}

{}

{}

Usa questo endpoint per creare un’attività video HappyHorse. L’API restituisce immediatamente un ID attività, quindi memorizza l’id restituito e interroga l’attività finché non raggiunge uno stato terminale. POST /v1/videos usa multipart/form-data; passa i controlli scalari come campi del form e le immagini di riferimento come campi file input_reference.

Scegli una modalità di input

Obiettivo	Model	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`, un file `input_reference`	`seconds`, `size`, altre immagini di riferimento

Per la modalità da riferimento a video, carica da 1 a 9 immagini di riferimento ripetendo il campo multipart input_reference. CometAPI invia ogni file caricato come immagine di riferimento HappyHorse. Usa immagini JPEG, JPG, PNG o WEBP fino a 20 MB ciascuna; per risultati ottimali, usa immagini con il lato più corto di almeno 400 px.

Imposta durata e dimensione

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

Imposta size su un valore WxH esatto.

Model	Forma del frame	Valori `size`
`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 ampio	`2520x1080`
	Verticale ampio	`1080x2520`
	Orizzontale quasi quadrato	`900x720`, `1350x1080`
	Verticale quasi quadrato	`720x900`, `1080x1350`

Flusso dell’attività

Crea l'attività

Invia la richiesta del form multipart e memorizza l’id restituito.

Interroga l'attività

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

Scarica il risultato

Quando l’attività è completed, chiama Recuperare il contenuto di un 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 reference-image requests, combine the prompt with the uploaded reference image.

Esempio:

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

Esempio:

"3"

size

string

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

Esempio:

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

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.

Recuperare un video Seedance

Recuperare un video HappyHorse

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 dimensione

Flusso dell’attività

Autorizzazioni

Corpo

Risposta

​Scegli una modalità di input

​Imposta durata e dimensione

​Flusso dell’attività

Autorizzazioni

Corpo

Risposta

Scegli una modalità di input

Imposta durata e dimensione

Flusso dell’attività