PixVerse V6 API

PixVerse V6 Texto para vídeo transforma um roteiro escrito em um clipe de 1 a 15 segundos em 360p, 540p, 720p ou 1080p, em oito proporções, de 16:9 a 9:16 e 21:9. Descreva o sujeito, a ação e a câmera; os movimentos de câmera escritos no prompt são seguidos, e a PixVerse diz que o V6 entende mais de 20 controles cinematográficos de lente e câmera a partir do prompt. Ligue generate_audio e o modelo gera som junto com a imagem. 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

Um parágrafo, mais de um enquadramento

No nosso teste, um único parágrafo sobre uma motorista rindo num conversível vintage azul-petróleo começou com um close dela, com o lenço voando, e depois a câmera subiu até uma vista aérea ampla do carro numa estrada do penhasco acima do oceano. O prompt pedia que o drone recuasse e subisse; a passagem do close para a aérea veio do modelo.

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. Isso não muda o preço.

Oito proporções

16:9 (padrão), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 e 21:9. A proporção não muda o preço.

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.

Quatro resoluções

360p, 540p, 720p (padrão) e 1080p. Nosso clipe de teste foi em 540p, 1024x576, e levou cerca de 41 segundos de geração para 5 segundos de vídeo.

Planos de abertura e de estabelecimento

Descreva o lugar, a luz, um movimento de câmera e o look, e você tem um plano para abrir uma cena. O nosso exemplo da estrada do penhasco faz exatamente isso em um parágrafo.

Cenas curtas com uma fala

Ligue o áudio, descreva a ação e coloque a fala entre aspas. Nomeie no mesmo prompt o ambiente que você quer.

Enquadramento vertical e ultralargo

Escolha 9:16, 3:4 ou 2:3 para clipes verticais, ou 21:9 para ultralargo. O preço por segundo é o mesmo em todas as proporções.

# 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/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "shot_type": "single",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "duration_seconds": 5
  }
}'

# 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.