Crear un video de 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 este endpoint para crear una tarea de video de HappyHorse. La API devuelve un ID de tarea de inmediato, así que guarda el id devuelto y consulta la tarea hasta que alcance un estado terminal. POST /v1/videos usa multipart/form-data; pasa los controles escalares como campos del formulario y las imágenes de referencia como campos de archivo input_reference.

Elige un modo de entrada

Objetivo	Model	Campos obligatorios	Campos opcionales
Texto a video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referencia a video	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, un archivo `input_reference`	`seconds`, `size`, más imágenes de referencia

Para referencia a video, sube de 1 a 9 imágenes de referencia repitiendo el campo multipart input_reference. CometAPI envía cada archivo subido como una imagen de referencia de HappyHorse. Usa imágenes JPEG, JPG, PNG o WEBP de hasta 20 MB cada una; para obtener mejores resultados, usa imágenes con un lado más corto de al menos 400 px.

Configura la duración y el tamaño

Model ID	`seconds`	Predeterminado
`happyhorse-1.0`	entero `3`-`15`	`5` segundos, `1920x1080`
`happyhorse-1.1`	entero `3`-`15`	`5` segundos, `1920x1080`

Configura size con un valor exacto WxH.

Model	Forma del fotograma	Valores de `size`
`happyhorse-1.0`	Horizontal	`1280x720`, `1920x1080`
	Vertical	`720x1280`, `1080x1920`
	Cuadrado	`1440x1440`
`happyhorse-1.1`	Horizontal	`1280x720`, `1920x1080`
	Vertical	`720x1280`, `1080x1920`
	Cuadrado	`1440x1440`
	Horizontal clásico	`1440x1080`
	Vertical clásico	`720x960`, `1080x1440`
	Horizontal panorámico	`2520x1080`
	Vertical panorámico	`1080x2520`
	Horizontal casi cuadrado	`900x720`, `1350x1080`
	Vertical casi cuadrado	`720x900`, `1080x1350`

Flujo de la tarea

Crear la tarea

Envía la solicitud de formulario multipart y guarda el id devuelto.

Consultar la tarea

Llama a Recuperar un video de HappyHorse hasta que status sea completed, failed o error.

Descargar el resultado

Cuando la tarea esté completed, llama a Recuperar el contenido del video de HappyHorse para descargar el archivo MP4.

Autorizaciones

Authorization

string

header

requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

multipart/form-data

model

enum<string>

requerido

HappyHorse model ID for this endpoint.

Opciones disponibles:

happyhorse-1.0,

happyhorse-1.1

Ejemplo:

"happyhorse-1.1"

prompt

string

requerido

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

Ejemplo:

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

Ejemplo:

"3"

size

string

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

Ejemplo:

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

Respuesta

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

string

requerido

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

Ejemplo:

"task_example"

object

string

requerido

Object type. Video tasks return video.

Ejemplo:

"video"

model

string

requerido

Model ID used for the task.

Ejemplo:

"happyhorse-1.1"

status

enum<string>

requerido

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

Opciones disponibles:

queued,

in_progress,

completed,

failed,

error

Ejemplo:

"queued"

progress

integer

requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100

Ejemplo:

0

created_at

integer

requerido

Task creation time as a Unix timestamp in seconds.

Ejemplo:

1779938152

task_id

string

Compatibility alias for id when present.

Ejemplo:

"task_example"

completed_at

integer

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

Ejemplo:

1779938219

video_url

string

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

Ejemplo:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Recuperar un video de Seedance

Recuperar un video de 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
}

{}

{}

Moderación de contenido

Claves API

Elige un modo de entrada

Configura la duración y el tamaño

Flujo de la tarea

Autorizaciones

Cuerpo

Respuesta

​Elige un modo de entrada

​Configura la duración y el tamaño

​Flujo de la tarea

Autorizaciones

Cuerpo

Respuesta

Elige un modo de entrada

Configura la duración y el tamaño

Flujo de la tarea