Introdução
PixVerse V6 Imagem para vídeo anima um primeiro quadro num clipe de 1 a 15 segundos em 360p, 540p, 720p ou 1080p. Adicione last_image_url e o clipe passa do primeiro para o último quadro. O prompt é obrigatório e descreve o que acontece. O clipe mantém a proporção da sua primeira imagem. As imagens são JPG, JPEG, PNG ou WebP, de até 20 MB cada. A PixVerse revisa prompts e imagens antes de gerar; as requisições que ela recusa falham e não são cobradas.
Escolha um modo do PixVerse V6 pelo material inicial
| O que você tem no início | Modo |
|---|---|
| uma cena escrita | PixVerse V6 Texto para vídeo |
| um primeiro quadro, e opcionalmente um último quadro | PixVerse V6 Imagem para vídeo (você está aqui) |
| fotos de pessoas, objetos ou lugares para escalar | PixVerse V6 Referência para vídeo |
| um clipe que você quer continuar | PixVerse V6 Extensão de vídeo |
| um prompt ou uma imagem, e você quer mais qualidade de imagem | PixVerse V6 Max |
| uma foto e um template temático pronto, sem prompt para escrever | PixVerse V6 Effects |
Recursos e destaques
Primeiro quadro, último quadro opcional
image_url define o início e last_image_url define o fim. No nosso teste, uma mulher de casaco ferrugem na fenda aberta de uma cúpula branca de observatório (primeiro quadro) e a mesma mulher recostada no corrimão, de braços cruzados (último quadro), viraram um só movimento: ela se vira, caminha ao longo do corrimão, se recosta e cruza os braços, e o clipe termina no último quadro.
A forma segue a sua imagem
Não há campo de proporção. Uma imagem em retrato volta como clipe em retrato, e uma imagem larga como clipe largo.
A opção de multiplanos
shot_type vem como single por padrão. Escolha multi para deixar o modelo cortar o clipe em vários planos. Ela não pode ser combinada com um último quadro.
Som quando você quiser
generate_audio vem desligado por padrão. Ligado, o modelo gera ambiente, efeitos, música e qualquer diálogo que você escrever entre aspas. Com o som ligado, o preço por segundo é maior.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Obrigatório, de 3 a 5.000 caracteres. Descreva o que acontece entre os quadros e depois deles: a ação e a câmera. pelo menos 3 caracteres · no máximo 5000 caracteres |
image_url | Sim | Obrigatório. O primeiro quadro, em JPG, JPEG, PNG ou WebP, de até 20 MB. |
last_image_url | Não | Último quadro opcional, com os mesmos formatos e tamanho. Com ele, o clipe passa da primeira imagem para a última. |
resolution | Não | 360p, 540p, 720p (padrão) ou 1080p. Resoluções maiores custam mais por segundo. |
duration_seconds | Não | Segundos inteiros, de 1 a 15 (padrão 5). O preço é por segundo. |
generate_audio | Não | Desligado por padrão. Ligado, gera som junto com a imagem: ambiente, efeitos, música e diálogos escritos entre aspas. Valor padrão: |
shot_type | Não | single (padrão) ou multi. multi deixa o modelo cortar o clipe em vários planos e não pode ser combinado com um último quadro. |
seed | Não | Número inteiro opcional, de 0 a 2147483647. Útil para comparar uma mudança por vez; não garante quadros idênticos. |
Preços
Cobrado por segundo de saída. A resolução e a opção de áudio mudam o preço por segundo; tipo de plano e seed não mudam. Requisições com falha ou recusadas não são cobradas.
| Resolução | Gerar áudio: Não | Gerar áudio: Sim |
|---|---|---|
| $0.0222 / segundo | $0.0311 / segundo |
| $0.0311 / segundo | $0.04 / segundo |
| $0.04 / segundo | $0.0533 / segundo |
| $0.08 / segundo | $0.1022 / segundo |
Casos de uso
Dê vida a uma imagem parada
Um retrato, uma cena de rua ou um quadro salvo de um clipe anterior. Descreva o que acontece em seguida, e a pessoa, o figurino e o cenário vêm da imagem.
Mova-se entre duas poses
Dê um último quadro diferente do primeiro e deixe o modelo preencher o movimento, como no nosso exemplo do observatório.
Mantenha um personagem entre os planos
Salve um quadro de um clipe e use-o como primeiro quadro do próximo para levar uma pessoa e um cenário de um plano para o outro.
Guia de prompt e dicas práticas
Descreva o movimento, não a imagem
A imagem já mostra como tudo é. Gaste o prompt com a ação, o movimento de câmera e, se o áudio estiver ligado, o som.
Mantenha os dois quadros consistentes
Use a mesma pessoa e o mesmo cenário no primeiro e no último quadro. Quadros que não batem não deixam ao modelo um movimento natural entre eles.
Dê espaço a cada momento
No nosso teste do posto de gasolina, o prompt listava uma lâmpada, um mapa, uma caminhada e um caminhão que passa; o homem dobrou o mapa, guardou e caminhou até o carro, e o caminhão com os faróis acesos apareceu no último segundo do clipe de 5 segundos. Peça menos momentos, ou acrescente segundos, se um momento tardio for importante.
Compare com o mesmo seed
seed mantém as execuções comparáveis enquanto você muda uma coisa por vez. Não garante quadros idênticos.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6/image-to-video",
"input": {
"duration_seconds": 5,
"generate_audio": false,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"shot_type": "single"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
