Criar um vídeo Vidu

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Use este endpoint para criar uma tarefa de text-to-video ou image-to-video do Vidu Q3. A API retorna imediatamente um ID de tarefa; portanto, armazene o id retornado e consulte a tarefa até que ela atinja um status terminal. POST /v1/videos usa multipart/form-data. Envie os controles escalares como campos de formulário e faça referência às imagens como campos de arquivo input_reference.

Escolha um modo de entrada

Objetivo	Campos obrigatórios	Campos opcionais
Text-to-video	`model`, `prompt`	`seconds`, `size`
Image-to-video	`model`, `prompt`, um arquivo `input_reference`	`seconds`, `size`

Para confirmar um ID de modelo Vidu disponível para sua chave de API, use Listar modelos disponíveis.

Usar imagens de referência

Para image-to-video, carregue uma imagem de referência pelo campo multipart input_reference. O arquivo pode ter até 20 MB. A imagem orienta a composição e a aparência do vídeo gerado. Use o prompt para descrever o movimento, o comportamento da câmera e os detalhes que o vídeo deve preservar.

Defina a duração e o tamanho

ID do modelo	`seconds`	Padrão
`viduq3-turbo`	inteiro `1`-`16`	`5` segundos, `1280x720`
`viduq3`	inteiro `1`-`16`	`5` segundos, `1280x720`

Defina size como um dos valores WxH abaixo.

Nível de resolução	Proporção da tela	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

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 Vidu até que status seja completed, failed ou error.

Baixar o resultado

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

Autorizações

Authorization

string

header

obrigatório

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

string

obrigatório

Vidu Q3 model ID for this route. Choose an available model from the Models page.

Exemplo:

"viduq3-turbo"

prompt

string

obrigatório

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Exemplo:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

seconds

string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Exemplo:

"1"

size

string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

input_reference

file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

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:

"viduq3-turbo"

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 12 de agosto de 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderação de conteúdo

Chaves de API

Escolha um modo de entrada

Usar imagens de referência

Defina a duração e o tamanho

Fluxo da tarefa

Autorizações

Corpo

Resposta

​Escolha um modo de entrada

​Usar imagens de referência

​Defina a duração e o tamanho

​Fluxo da tarefa

Autorizações

Corpo

Resposta

Escolha um modo de entrada

Usar imagens de referência

Defina a duração e o tamanho

Fluxo da tarefa