Créer une vidéo 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
}

{}

{}

Utilisez ce endpoint pour créer une tâche vidéo HappyHorse. L’API renvoie immédiatement un ID de tâche, alors stockez l’id renvoyé et interrogez la tâche jusqu’à ce qu’elle atteigne un statut terminal. POST /v1/videos utilise multipart/form-data ; transmettez les contrôles scalaires comme champs de formulaire et les images de référence comme champs de fichier input_reference.

Choisir un mode d’entrée

Objectif	Modèle	Champs requis	Champs facultatifs
Text-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Reference-to-video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, un fichier `input_reference`	`seconds`, `size`, plus d’images de référence

Pour le reference-to-video, téléversez 1 à 9 images de référence en répétant le champ multipart input_reference. CometAPI envoie chaque fichier téléversé comme image de référence HappyHorse. Utilisez des images JPEG, JPG, PNG ou WEBP jusqu’à 20 MB chacune ; pour de meilleurs résultats, utilisez des images dont le côté le plus court mesure au moins 400 px.

Définir la durée et la taille

Model ID	`seconds`	Par défaut
`happyhorse-1.0`	entier `3`-`15`	`5` secondes, `1920x1080`
`happyhorse-1.1`	entier `3`-`15`	`5` secondes, `1920x1080`

Définissez size sur une valeur exacte WxH.

Modèle	Format d’image	Valeurs de `size`
`happyhorse-1.0`	Paysage	`1280x720`, `1920x1080`
	Portrait	`720x1280`, `1080x1920`
	Carré	`1440x1440`
`happyhorse-1.1`	Paysage	`1280x720`, `1920x1080`
	Portrait	`720x1280`, `1080x1920`
	Carré	`1440x1440`
	Paysage classique	`1440x1080`
	Portrait classique	`720x960`, `1080x1440`
	Paysage large	`2520x1080`
	Portrait large	`1080x2520`
	Paysage quasi carré	`900x720`, `1350x1080`
	Portrait quasi carré	`720x900`, `1080x1350`

Flux de tâche

Créer la tâche

Envoyez la requête de formulaire multipart et stockez l’id renvoyé.

Interroger la tâche

Appelez Retrieve a HappyHorse video jusqu’à ce que status soit completed, failed ou error.

Télécharger le résultat

Lorsque la tâche est completed, appelez Retrieve HappyHorse video content pour télécharger le fichier MP4.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data

model

enum<string>

requis

HappyHorse model ID for this endpoint.

Options disponibles:

happyhorse-1.0,

happyhorse-1.1

Exemple:

"happyhorse-1.1"

prompt

string

requis

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

Exemple:

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

Exemple:

"3"

size

string

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

Exemple:

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

Réponse

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

string

requis

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

Exemple:

"task_example"

object

string

requis

Object type. Video tasks return video.

Exemple:

"video"

model

string

requis

Model ID used for the task.

Exemple:

"happyhorse-1.1"

status

enum<string>

requis

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

Options disponibles:

queued,

in_progress,

completed,

failed,

error

Exemple:

"queued"

progress

integer

requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100

Exemple:

0

created_at

integer

requis

Task creation time as a Unix timestamp in seconds.

Exemple:

1779938152

task_id

string

Compatibility alias for id when present.

Exemple:

"task_example"

completed_at

integer

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

Exemple:

1779938219

video_url

string

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

Exemple:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Récupérer une vidéo Seedance

Récupérer une vidéo 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
}

{}

{}

Modération de contenu

Clés API

Choisir un mode d’entrée

Définir la durée et la taille

Flux de tâche

Autorisations

Corps

Réponse

​Choisir un mode d’entrée

​Définir la durée et la taille

​Flux de tâche

Autorisations

Corps

Réponse

Choisir un mode d’entrée

Définir la durée et la taille

Flux de tâche