Video
PixVerse V6 Max
Gere com o PixVerse V6 Max clipes de 1 a 15 segundos a partir de um prompt ou de uma imagem, de 360p a 1080p com áudio opcional, cobrados por segundo e entregues como tarefa.
O PixVerse V6 Max é a versão com mais detalhes do PixVerse V6. Ele cria um clipe de 1 a 15 segundos a partir de um prompt, ou de uma imagem inicial com prompt opcional, 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
| ID de modelo | Entradas | Resoluções | Duração |
|---|---|---|---|
pixverse-v6-max | texto, uma imagem | 360p, 540p, 720p, 1080p | De 1 a 15 segundos |
Veja a página do modelo para os preços atuais. Transições, referência com várias imagens e extensão são recursos do PixVerse V6.
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-max",
"prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist, slow push-in. No text, no logos.",
"resolution": "720p",
"duration": 5,
"aspect_ratio": "16:9"
}'Endpoint
POST https://api.seedrouter.ai/v1/videos/generations| Cabeçalho | Valor |
|---|---|
| Authorization | Bearer YOUR_API_KEY |
| Content-Type | application/json |
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
| Campo | Tipo | Padrão | Observações |
|---|---|---|---|
model | string | obrigatório | pixverse-v6-max |
prompt | string | veja observações | Texto para vídeo: obrigatório, até 5.000 caracteres. Com uma imagem: opcional, até 2.048 caracteres. |
image_urls | lista de URLs | nenhum | Imagem para vídeo: exatamente uma imagem. Sem ela, o clipe é de texto para vídeo. |
resolution | enum | 540p | 360p, 540p, 720p ou 1080p. |
quality | enum | nenhum | Alias de resolution, com os mesmos valores. resolution prevalece quando ambos são enviados. |
duration | integer | 5 | De 1 a 15 segundos. |
aspect_ratio | enum | 16:9 | 16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 ou 21:9. Apenas para texto para vídeo; com uma imagem, o clipe segue o formato dela. |
audio | boolean | false | Gera áudio nativo. Cobrado na tarifa com áudio. |
seed | integer | nenhum | 0–2147483647. A mesma requisição e semente geram resultados semelhantes. |
O esquema é estrito: campos desconhecidos são rejeitados em vez de ignorados. first_frame_image, last_frame_image, img_references e extend_from_task_id retornam um 400 que indica pixverse-v6. callback_url não está disponível; consulte a tarefa.
Imagem para vídeo
Passe uma imagem em image_urls. O clipe começa nela e mantém seu formato, então uma imagem vertical gera um clipe vertical. Aqui o prompt é opcional.
{
"model": "pixverse-v6-max",
"prompt": "The subject slowly turns toward the camera, soft natural light.",
"image_urls": ["https://example.com/start.png"],
"resolution": "1080p",
"duration": 5
}Entradas de mídia
A imagem é uma URL HTTP(S) pública. Data URIs em base64 não são aceitos: envie o arquivo para o seu próprio armazenamento e passe a URL dele. Use uma imagem JPG, PNG ou WebP de até 20 MB e no máximo 10.000 pixels em cada lado.
Fatores de custo
Veja a seção de preços do modelo para as tarifas atuais. O PixVerse V6 Max é 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 settingTexto para vídeo e imagem para vídeo custam o mesmo. 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-max", "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-max",
"status": "completed",
"created_at": 1789689600,
"finished_at": 1789689690,
"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 81 e 89 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-max",
"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
audioestiver ativado. - Faça o rascunho em
360pou540pe depois renderize a cena final em1080pcom a mesma requisição eseed. - Para vídeo vertical, envie
aspect_ratio: "9:16"ou uma imagem vertical. - Adicione
no text, no logospara evitar marcas inventadas.
