Pixverse v6
Pixverse v6 Geração de Vídeo
- Modelo unificado de geração de vídeo Pixverse v6
- Suporta texto-para-vídeo, imagem-para-vídeo, transição entre primeiro/último frame, fusão de múltiplas imagens de referência e extensão de vídeo
- Suporta resoluções 360p/540p/720p/1080p, duração de 1–15 segundos
- API de tarefas assíncronas: após o envio, consulte o resultado pelo ID da tarefa
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 comomni-moderation-latestfalseou 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: SD540p: Padrão (padrão)720p: HD1080p: Full HD
integer
padrão:"5"
Duração do vídeo em segundos, faixa
1–15.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:31:1: Quadrado3:4: Retrato 3:49:16: Retrato vertical2:3: Retrato 2:33:2: Paisagem 3:221: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’águafalse: Sem marca d’água (padrão)
string
Modo de movimento.
normal: Modo padrão (pixverse-v6suporta apenas este valor)
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 clipesfalse: 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.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, umtask_id é retornado. Use o endpoint Obter status da tarefa para consultar progresso e resultado.
cURL
completed ou failed.
Exemplo de sucesso
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
cost geralmente é 0. A causa do erro está em data.error.message.