Criar um vídeo Wan

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Crie um vídeo Wan a partir de texto, mídia de referência ou quadros inicial e final. Armazene o id retornado para consultar a tarefa e baixar o vídeo concluído. POST /v1/videos usa multipart/form-data. Envie um valor inteiro explícito de seconds e um(a) size no formato WxH.

Escolha um modo de entrada

Todos os modos exigem model e prompt. As entradas de mídia disponíveis dependem do modelo:

Objetivo	IDs de modelo	Campos de mídia
Texto para vídeo	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Omita os campos de mídia
Imagem para vídeo	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URLs ou arquivos de imagem enviados
Vídeo de referência	`wan2.6`	`reference_videos` somente
Referências de imagem e vídeo	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` com `reference_videos`
Referências de imagem, vídeo e áudio	`wan3.0`, `wan3.0-prime`	Referências de imagem/vídeo com `reference_audios`
Quadros inicial e final	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, opcionalmente `last_frame`

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

Usar imagens de referência

Para wan2.7, wan3.0 e wan3.0-prime, envie imagens de referência por meio de input_reference como URLs HTTPS acessíveis publicamente ou arquivos enviados. Para várias imagens, repita o campo na ordem das imagens, com uma URL ou arquivo por campo. Use somente URLs ou somente arquivos em input_reference. Envie cada URL separadamente, em vez de combinar URLs em um valor separado por vírgulas. Use imagens PNG ou JPEG de até 20 MB cada. Uma única URL ou arquivo input_reference usa o fluxo de trabalho de imagem para vídeo. A imagem orienta a composição e a aparência; use o prompt para descrever o movimento e o comportamento da câmera. Para wan3.0 e wan3.0-prime, envie no máximo 10 imagens de referência por meio de input_reference, independentemente de usar URLs ou arquivos enviados.

Use vídeos e áudio de referência

Envie vídeos por meio de reference_videos e clipes de áudio por meio de reference_audios, repetindo cada campo uma vez para cada entrada. Cada entrada pode ser uma URL HTTPS acessível publicamente ou um arquivo carregado. Use arquivos MP4 com vídeo codificado em H.264 para referências de vídeo. Use arquivos MP3 separados para referências de áudio. Campos diferentes podem usar tipos de entrada diferentes, como uma URL de imagem com vídeos carregados. Em reference_videos ou reference_audios, use somente URLs ou somente arquivos. Você pode carregar até cinco arquivos de vídeo, cada um com no máximo 50 MiB (50 × 1024 × 1024 bytes). Você pode carregar até cinco arquivos de áudio, cada um com no máximo 15 MiB (15 × 1024 × 1024 bytes).

Referências de vídeo do Wan 2.6

Envie de uma a três reference_videos, cada uma com 2 a 30 segundos, até 30 MB e pelo menos 16 fps. Esses limites se aplicam tanto a URLs quanto a vídeos carregados. No Prompt, faça referência aos assuntos como @Video1, @Video2 e @Video3, na ordem de entrada. Para este modo, omita input_reference, reference_audios, first_frame e last_frame. Defina seconds como 5 ou 10. Estes exemplos criam um vídeo de cinco segundos a partir de duas referências de vídeo. Substitua as URLs de mídia ou os nomes de arquivo pelas suas entradas:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=https://your-media-host/reference-1.mp4' \
  -F 'reference_videos=https://your-media-host/reference-2.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=@reference-1.mp4;type=video/mp4' \
  -F 'reference_videos=@reference-2.mp4;type=video/mp4'

Referências de imagem e vídeo do Wan 2.7

Combine referências de imagem e vídeo para orientar a aparência e o movimento do assunto. Defina seconds como um número inteiro de 2 a 10. Omita reference_audios. Use duas URLs de imagem ou duas imagens carregadas com uma referência de vídeo:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4'

Referências de imagem, vídeo e áudio do Wan 3.0

Para wan3.0 e wan3.0-prime, combine referências de imagem e vídeo com referências de áudio para orientar a aparência, o movimento e o ritmo. Envie no máximo cinco referências de vídeo com duração combinada de no máximo 15 segundos. Cada vídeo deve ter pelo menos 16 fps. Envie no máximo cinco referências de áudio com duração combinada de no máximo 15 segundos. Conte as durações de vídeo e áudio separadamente. Defina o seconds de saída como um número inteiro de 2 a 30. Use duas URLs de imagem ou duas imagens carregadas com um vídeo e dois clipes de áudio:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4' \
  -F 'reference_audios=https://your-media-host/reference-1.mp3' \
  -F 'reference_audios=https://your-media-host/reference-2.mp3'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4' \
  -F 'reference_audios=@reference-1.mp3;type=audio/mpeg' \
  -F 'reference_audios=@reference-2.mp3;type=audio/mpeg'

Use os primeiros e últimos quadros

Para wan2.7, wan3.0 e wan3.0-prime, envie first_frame para a imagem inicial e, opcionalmente, last_frame para a imagem final. Cada campo aceita uma URL HTTPS de PNG ou JPEG acessível publicamente ou um arquivo PNG ou JPEG carregado. Para entradas de quadro do Wan 2.7, a imagem inicial determina a proporção de aspecto, enquanto size seleciona o nível de resolução de saída. Envie as entradas de quadro em uma solicitação separada de input_reference, reference_videos e reference_audios. Estes exemplos do Wan 2.7 criam uma transição entre os quadros inicial e final:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Estes exemplos do Wan 3.0 criam uma transição entre os quadros inicial e final:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Definir duração e tamanho

Envie seconds como um número inteiro dentro do intervalo do seu modelo e modo de entrada.

ID do modelo	Modo de entrada	`seconds`	Padrão
`wan3.0`, `wan3.0-prime`	Texto, referências ou quadros	inteiro `2`–`30`	`5` segundos, `1920x1080`
`wan2.7`	Texto	inteiro `2`–`15`	`5` segundos, `1920x1080`
`wan2.7`	Quadros	inteiro `2`–`15`	`5` segundos, nível `1080p`; a proporção de aspecto segue a imagem inicial
`wan2.7`	Referências de imagem/vídeo	inteiro `2`–`10`	`5` segundos, `1920x1080`
`wan2.6`	Texto	`5`, `10`, `15`	`5` segundos, `1920x1080`
`wan2.6`	Referências de vídeo	`5`, `10`	`5` segundos, `1920x1080`

Defina size como um dos valores WxH abaixo para o modelo de destino. Os valores de tamanho do Wan 3.0 também se aplicam a wan3.0-prime.

Valores de tamanho do Wan 3.0

Nível de resolução	Proporção de aspecto	`size` (`WxH`)
`480p`	`16:9`	`832x480`
	`9:16`	`480x832`
	`1:1`	`624x624`
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`1:1`	`960x960`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Valores de tamanho do Wan 2.7

Nível de resolução	Proporção de aspecto	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Valores de tamanho do Wan 2.6

Nível de resolução	Proporção de aspecto	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Fluxo de tarefas

Criar a tarefa

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

Consultar a tarefa

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

Baixar o resultado

Quando a tarefa estiver completed, chame Recuperar conteúdo de vídeo Wan 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

Wan model ID: wan2.6, wan2.7, wan3.0, or wan3.0-prime. Use wan2.6 for text or reference-video input. Use wan2.7 for text, image/video references, or frame inputs. Use wan3.0 or wan3.0-prime to also include reference audio.

Exemplo:

"wan3.0"

prompt

string

obrigatório

Text prompt that describes the video to generate. Describe the appearance and motion to preserve from references, or the transition between first_frame and last_frame. For wan2.6 video references, use @Video1, @Video2, and @Video3 in input order.

Exemplo:

"A small robot walks through a bright greenhouse with smooth camera movement."

seconds

integer

Requested output duration in whole seconds. Send an explicit integer. For wan2.6 reference-to-video, use 5 or 10; text-to-video also accepts 15. For wan2.7 reference-to-video, use 2 through 10; text and frame inputs accept 2 through 15. For wan3.0 and wan3.0-prime, use 2 through 30. Default is 5.

Intervalo necessário: 2 <= x <= 30

Exemplo:

5

size

string

Supported WxH size values. For wan3.0 and wan3.0-prime: 832x480, 480x832, 624x624, 640x480, 480x640, 1280x720, 720x1280, 960x960, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Exemplo:

"1920x1080"

input_reference

PNG or JPEG reference images for wan2.7, wan3.0, and wan3.0-prime. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. A single URL or file uses the image-to-video workflow. Each image can be up to 20 MB. For wan3.0 and wan3.0-prime, send at most 10 reference images, whether you use URLs or uploaded files. Image and video references can share a request; reference audio requires wan3.0 or wan3.0-prime. Submit frame inputs separately. Omit for text-to-video and wan2.6 reference-to-video. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference videos for wan2.6, wan2.7, wan3.0, and wan3.0-prime. Repeat reference_videos with publicly accessible HTTPS URLs or uploaded MP4 files with H.264 video. Use one input type within this field: all URLs or all files. For wan2.6, send 1 to 3 clips, each 2 to 30 seconds and up to 30 MB, with at least 16 fps; omit image, audio, and frame fields. For wan2.7, combine video references with image references. For wan3.0 and wan3.0-prime, send at most 5 clips totaling at most 15 seconds, with at least 16 fps. Video uploads are limited to 5 files, each at most 50 MiB (50 x 1024 x 1024 bytes); the lower wan2.6 limits still apply. Submit frame inputs separately.

Minimum array length: 1

Pattern: ^https://

reference_audios

(string<uri> | file)[]

Reference audio for wan3.0 and wan3.0-prime, combined with image or video references. Repeat reference_audios with publicly accessible HTTPS MP3 URLs or uploaded MP3 files. Use one input type within this field: all URLs or all files. Send at most 5 audio references totaling at most 15 seconds, counted separately from reference video duration. Audio uploads are limited to 5 files, each at most 15 MiB (15 x 1024 x 1024 bytes). Submit frame inputs separately. Omit for wan2.6 and wan2.7.

Minimum array length: 1

Pattern: ^https://

first_frame

Opening frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use first_frame alone or add last_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

last_frame

Ending frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use with first_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

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:

"wan3.0"

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=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "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

Use vídeos e áudio de referência

Referências de vídeo do Wan 2.6

Referências de imagem e vídeo do Wan 2.7

Referências de imagem, vídeo e áudio do Wan 3.0

Use os primeiros e últimos quadros

Definir duração e tamanho

Valores de tamanho do Wan 3.0

Valores de tamanho do Wan 2.7

Valores de tamanho do Wan 2.6

Fluxo de tarefas

Autorizações

Corpo

Resposta

​Escolha um modo de entrada

​Usar imagens de referência

​Use vídeos e áudio de referência

​Referências de vídeo do Wan 2.6

​Referências de imagem e vídeo do Wan 2.7

​Referências de imagem, vídeo e áudio do Wan 3.0

​Use os primeiros e últimos quadros

​Definir duração e tamanho

​Valores de tamanho do Wan 3.0

​Valores de tamanho do Wan 2.7

​Valores de tamanho do Wan 2.6

​Fluxo de tarefas

Autorizações

Corpo

Resposta

Escolha um modo de entrada

Usar imagens de referência

Use vídeos e áudio de referência

Referências de vídeo do Wan 2.6

Referências de imagem e vídeo do Wan 2.7

Referências de imagem, vídeo e áudio do Wan 3.0

Use os primeiros e últimos quadros

Definir duração e tamanho

Valores de tamanho do Wan 3.0

Valores de tamanho do Wan 2.7

Valores de tamanho do Wan 2.6

Fluxo de tarefas