PixVerse V6

O PixVerse V6 é o modelo de vídeo da PixVerse. Um só ID de modelo cobre cinco modos: texto para vídeo, imagem para vídeo, transição entre um primeiro e um último quadro, referência com várias imagens e extensão de um clipe que você já fez. O modo depende dos campos enviados. Os clipes duram de 1 a 15 segundos em 360p, 540p, 720p ou 1080p, com áudio nativo opcional. Envie a requisição, guarde o ID da tarefa retornado e leia o vídeo pronto a partir da tarefa. As imagens são enviadas como URLs.

IDs de modelo

Veja a página do modelo para os preços atuais. Para uma cena com mais detalhes a partir de texto ou de uma imagem, veja o PixVerse V6 Max.

Exemplo rápido

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pixverse-v6",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
    "resolution": "540p",
    "duration": 5,
    "size": "16:9"
  }'

Endpoint

POST https://api.seedrouter.ai/v1/videos/generations

A resposta é uma tarefa ({"id": "task_...", "status": "processing"}), não o vídeo pronto. Consulte GET /v1/tasks/{task_id} para obter o resultado. Mantenha as chaves de API no código do lado do servidor.

Parâmetros

O esquema é estrito: campos desconhecidos são rejeitados em vez de ignorados. callback_url não está disponível; consulte a tarefa.

Modos

Os campos enviados escolhem o modo. Envie os campos de um só modo por requisição.

{
  "model": "pixverse-v6",
  "prompt": "The puppy slowly turns into a kitten, soft studio light.",
  "first_frame_image": "https://example.com/puppy.jpg",
  "last_frame_image": "https://example.com/kitten.jpg",
  "duration": 5
}

{
  "model": "pixverse-v6",
  "prompt": "The paper boat drifts on toward a lily pad.",
  "extend_from_task_id": "task_...",
  "resolution": "540p",
  "duration": 5
}

Uma extensão retorna o clipe de origem seguido do segmento novo e cobra apenas a duration do segmento novo. No nosso teste, uma extensão de 1 segundo de um clipe de 1 segundo voltou com 2,1 segundos de duração e foi cobrada como 1 segundo.

Entradas de mídia

As imagens são URLs HTTP(S) públicas. Data URIs em base64 não são aceitos: envie o arquivo para o seu próprio armazenamento e passe a URL dele. Use imagens JPG, PNG ou WebP de até 20 MB.

Fatores de custo

Veja a seção de preços do modelo para as tarifas atuais. O PixVerse V6 é cobrado por segundo de vídeo, com uma tarifa definida pela resolução e por gerar ou não áudio:

cost = duration × rate per second for the resolution and audio setting

Todos os modos custam o mesmo por segundo; uma extensão cobra apenas o segmento novo. A duração é conhecida quando a requisição é aceita, então o valor reservado é o valor cobrado. Veja as cobranças finais no histórico de uso da sua conta. Tarefas que falham não são cobradas.

Esquema de saída

O envio retorna a tarefa:

{"id": "task_...", "model": "pixverse-v6", "status": "processing", "created_at": 1789689600}

Consultar a tarefa

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Consulte a cada 10–20 segundos até que status seja completed ou failed. Um tempo limite de rede durante a consulta não significa que a geração falhou: guarde o ID da tarefa e retome a verificação. Não crie outra tarefa para acompanhar o progresso.

Tarefa concluída

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689640,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

Nos nossos testes, clipes de 1 segundo em 360p e 16:9 voltaram como MP4 (H.264) de 640 × 360, entre 36 e 45 segundos depois do envio.

Erros

Requisições rejeitadas antes de uma tarefa ser criada retornam um erro HTTP com um objeto error e não são cobradas. Uma tarefa que falha depois de aceita retorna HTTP 200 quando consultada, com status: "failed" e um objeto error.

Veja o catálogo de erros comum para códigos, status HTTP e orientações de nova tentativa.

{
  "id": "task_...",
  "model": "pixverse-v6",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Se o próprio envio atingir o tempo limite, confira suas tarefas antes de enviar de novo: a primeira requisição pode ter sido aceita.

Dicas

• Descreva assunto, lugar, movimento de câmera e luz no prompt; especifique os sons que você quer quando audio estiver ativado.
• Faça o rascunho em 360p ou 540p e depois renderize a cena final em 1080p com a mesma requisição e seed.
• Para vídeo vertical, envie size: "9:16" com texto para vídeo ou uma imagem vertical.
• Adicione no text, no logos para evitar marcas inventadas.

Relacionados

• Playground e preços do PixVerse V6
• Referência da API do PixVerse V6 Max
• Baixar o OpenAPI
• Markdown copiável