Criar um vídeo 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
}

Crie um vídeo HappyHorse a partir de texto, imagens de referência ou um quadro inicial. A API retorna um ID de tarefa imediatamente. Armazene o id retornado para consultar a tarefa e baixar o vídeo concluído. POST /v1/videos usa multipart/form-data. Envie os controles como campos de formulário e as imagens de referência como campos input_reference, com uma URL HTTPS ou um arquivo de imagem enviado por campo.

Escolha um modo de entrada

Objetivo	Modelo	Campos obrigatórios	Campos opcionais
Texto para vídeo	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`	`seconds`, `size`
Referência para vídeo	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, 1–9 `input_reference` URLs ou arquivos	`seconds`, `size`
Imagem do primeiro quadro para vídeo	`happyhorse-1.0`, `happyhorse-1.1`	`model`, `prompt`, uma URL ou arquivo `first_frame`	`seconds`, `size`

As imagens de referência orientam os assuntos e os detalhes visuais do vídeo. Envie de 1 a 9 URLs HTTPS de imagens publicamente acessíveis ou de 1 a 9 arquivos de imagem, repetindo input_reference uma vez por imagem, na ordem das imagens. Use apenas URLs ou apenas arquivos neste campo. Envie cada URL separadamente, em vez de unir URLs com vírgulas. Para input_reference, cada imagem de referência deve ter no máximo 10 MB com happyhorse-1.0. Com happyhorse-1.1, cada imagem de referência deve ter no máximo 20 MB. Esses limites do modelo se aplicam tanto a URLs de imagens quanto a arquivos enviados. Use imagens JPEG, JPG, PNG ou WEBP com o lado mais curto de pelo menos 400 px. O limite de upload de input_reference é de 20 MiB (20 × 1024 × 1024 bytes) por arquivo. As imagens enviadas também devem atender ao limite específico do modelo acima. Os exemplos de solicitação no início desta página mostram várias URLs de imagens para HappyHorse 1.1 e vários uploads de arquivos para ambos os modelos. Para definir o quadro inicial, envie first_frame uma vez com uma URL HTTPS de imagem publicamente acessível ou um arquivo de imagem. Use este campo em uma solicitação separada de input_reference.

Definir duração e tamanho

ID do modelo	`seconds`	Padrão
`happyhorse-1.0`	inteiro `3`-`15`	`5` segundos, `1920x1080`
`happyhorse-1.1`	inteiro `3`-`15`	`5` segundos, `1920x1080`

Escolha um valor exato de WxH para size na tabela abaixo. Para solicitações com primeiro quadro, a imagem determina o enquadramento e a proporção, enquanto size seleciona a categoria de resolução de saída.

Modelo	Formato do quadro	`size` valores
`happyhorse-1.0`	Paisagem	`1280x720`, `1920x1080`
	Retrato	`720x1280`, `1080x1920`
	Quadrado	`1440x1440`
`happyhorse-1.1`	Paisagem	`1280x720`, `1920x1080`
	Retrato	`720x1280`, `1080x1920`
	Quadrado	`1440x1440`
	Paisagem clássica	`1440x1080`
	Retrato clássico	`720x960`, `1080x1440`
	Paisagem ampla	`2520x1080`
	Retrato amplo	`1080x2520`
	Paisagem quase quadrada	`900x720`, `1350x1080`
	Retrato quase quadrado	`720x900`, `1080x1350`

Fluxo da tarefa

Criar a tarefa

Envie a solicitação de formulário multipart e armazene o id retornado.

Consultar a tarefa

Chame Recuperar um vídeo HappyHorse até que status seja completed, failed ou error.

Baixar o resultado

Quando a tarefa estiver completed, chame Recuperar conteúdo de vídeo HappyHorse para baixar o arquivo MP4.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

enum<string>

obrigatório

HappyHorse model ID for this endpoint.

Opções disponíveis:

happyhorse-1.0,

happyhorse-1.1

Exemplo:

"happyhorse-1.1"

prompt

string

obrigatório

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

Exemplo:

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

seconds

integer

padrão:5

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

Intervalo necessário: 3 <= x <= 15

Exemplo:

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.

Exemplo:

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

Resposta

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

string

obrigatório

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

Exemplo:

"task_example"

object

string

obrigatório

Object type. Video tasks return video.

Exemplo:

"video"

model

string

obrigatório

Model ID used for the task.

Exemplo:

"happyhorse-1.1"

status

enum<string>

obrigatório

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

Opções disponíveis:

queued,

in_progress,

completed,

failed,

error

Exemplo:

"queued"

progress

integer

obrigatório

Task progress as a coarse percentage.

Intervalo necessário: 0 <= x <= 100

Exemplo:

0

created_at

integer

obrigatório

Task creation time as a Unix timestamp in seconds.

Exemplo:

1779938152

task_id

string

Compatibility alias for id when present.

Exemplo:

"task_example"

completed_at

integer

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

Exemplo:

1779938219

video_url

string

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

Exemplo:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Última modificação em 9 de setembro de 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
}

Moderação de conteúdo

Chaves de API

Escolha um modo de entrada

Definir duração e tamanho

Fluxo da tarefa

Autorizações

Corpo

Resposta

​Escolha um modo de entrada

​Definir duração e tamanho

​Fluxo da tarefa

Autorizações

Corpo

Resposta

Escolha um modo de entrada

Definir duração e tamanho

Fluxo da tarefa