Skip to main content
POST

Autenticação

string
obrigatório
Todos os endpoints requerem autenticação via Bearer Token.Obter uma API Key:Acesse a página de gerenciamento de API Key para obter sua API Key.Adicione o seguinte cabeçalho à requisição:

Parâmetros da requisição

string
obrigatório
Nome do modelo de geração de vídeo. Fixo em pixverse-v6.
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de vídeo.
  • true: verificar prompts e imagens de entrada com omni-moderation-latest
  • false ou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
obrigatório
Descrição do conteúdo do vídeo, até 5000 caracteres. Obrigatório em todos os modos.
string
padrão:"540p"
Nível de resolução do vídeo. Afeta diretamente a cobrança.
  • 360p: SD
  • 540p: Padrão (padrão)
  • 720p: HD
  • 1080p: Full HD
Outros valores de resolução retornam erro de parâmetro.
integer
padrão:"5"
Duração do vídeo em segundos, faixa 1–15.
O modo de transição entre primeiro/último frame só suporta 5 ou 8 segundos.
string
padrão:"16:9"
Proporção do vídeo. Efetivo apenas nos modos texto-para-vídeo e fusão de múltiplas referências.
  • 16:9: Paisagem widescreen (padrão)
  • 4:3: Paisagem 4:3
  • 1:1: Quadrado
  • 3:4: Retrato 3:4
  • 9:16: Retrato vertical
  • 2:3: Retrato 2:3
  • 3:2: Paisagem 3:2
  • 21:9: Cinema widescreen
integer
padrão:"0"
Semente aleatória, faixa 0–2147483647. Mesmo prompt e seed reproduzem resultados similares.
string
Prompt negativo para excluir conteúdo indesejado. Até 2048 caracteres.
boolean
padrão:"false"
Indica se uma trilha de áudio deve ser gerada.
  • true: Gerar áudio (aumenta o preço)
  • false: Sem áudio (padrão)
boolean
padrão:"false"
Indica se uma marca d’água deve ser adicionada no canto inferior direito do vídeo.
  • true: Adicionar marca d’água
  • false: Sem marca d’água (padrão)
string
Modo de movimento.
  • normal: Modo padrão (pixverse-v6 suporta apenas este valor)
fast aplica-se apenas a modelos legados e será rejeitado pelo upstream para pixverse-v6.
boolean
padrão:"false"
Indica se um vídeo contínuo de múltiplos clipes deve ser gerado. Suportado apenas em texto-para-vídeo e imagem-para-vídeo.
  • true: Gerar vídeo contínuo de múltiplos clipes
  • false: Clipe único (padrão)
array<url>
Array de URLs de imagens de entrada para imagem-para-vídeo. Apenas a primeira é usada.As imagens devem ser URLs HTTP/HTTPS publicamente acessíveis.
url
URL do primeiro frame no modo de transição. Deve ser fornecido junto com last_frame_image.
url
URL do último frame no modo de transição. Deve ser fornecido junto com first_frame_image.
array<url>
Array de URLs de imagens de referência para o modo de fusão de múltiplas referências. Suporta 1–7 imagens.Fornecer este campo aciona o modo de fusão de múltiplas imagens de referência.
string
ID da tarefa de origem para extensão de vídeo. Fornecer este campo aciona o modo de extensão.A tarefa de origem deve pertencer ao usuário atual, usar o modelo pixverse-v6 e ter status completed.

Modos de geração

O adaptador despacha automaticamente para o modo de geração correspondente conforme os campos da requisição. A correspondência segue a ordem de prioridade; o primeiro a corresponder vence.
Todas as entradas de imagem aceitam apenas URLs HTTP/HTTPS publicamente acessíveis. base64 e Data URI não são suportados. Se você só tiver imagens locais, faça o upload para um object storage e forneça a URL.

Regras de parâmetros

Resposta

integer
Código de status da resposta. 200 em caso de sucesso.
array
Array de tarefas retornado.

Consulta do resultado da tarefa

A geração de vídeo é uma tarefa assíncrona. Após o envio, um task_id é retornado. Use o endpoint Obter status da tarefa para consultar progresso e resultado.
cURL
Recomenda-se fazer polling a cada 5 segundos até o status ficar completed ou failed.

Exemplo de sucesso

A URL do vídeo está em data.result.videos[0].url[0]. O campo url é, ele mesmo, um array. Os links de vídeo geralmente expiram após 24 horas — baixe ou transfira-os a tempo.

Exemplo de falha

Em caso de falha, cost geralmente é 0. A causa do erro está em data.error.message.

Casos de uso

Caso 1: Texto-para-vídeo

Caso 2: Imagem-para-vídeo

Caso 3: Transição primeiro/último frame

Caso 4: Fusão de múltiplas referências

Caso 5: Extensão de vídeo