PixVerse V6 API

PixVerse V6 Referência para vídeo monta um clipe a partir de imagens que você envia, com até 7 elementos numa só requisição. A PixVerse chama este modo de Fusion. Cada elemento tem um nome, uma imagem e um papel: subject para uma pessoa, animal, objeto ou produto, ou background para um lugar ou cenário. Escreva @name no prompt onde cada elemento deve aparecer. Os clipes têm de 1 a 15 segundos, em 360p a 1080p, em oito proporções. 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

Dê nome aos seus elementos

Dê a cada elemento um nome de 1 a 30 caracteres e chame-o com @name no prompt. No nosso teste, maya (uma foto de uma mulher ruiva de jaqueta mostarda) e trailer (uma foto de um trailer cromado) viraram uma cena de crepúsculo: ela caminha em direção à câmera com uma caneca de esmalte fumegante na frente do trailer, com luzes de cordão acesas. O rosto, o cabelo e a jaqueta combinaram com a referência, e o trailer também.

Coloque um espaço depois do nome

No nosso teste, “@trailer,” com vírgula logo depois do nome foi recusado porque o nome não correspondeu, enquanto “@trailer and” funcionou. Requisições com falha não são cobradas. Escreva @name seguido de um espaço.

Sujeitos e cenários

Defina role como subject (padrão) para pessoas, animais, objetos e produtos, ou como background para um lugar. Uma requisição pode misturar até 7 deles.

Pequenos artefatos acontecem

No nosso exemplo, um quadro mostrou brevemente uma segunda figura na porta. Confira o clipe antes de publicar.

Coloque uma pessoa num lugar onde ela nunca foi fotografada

Um retrato como um elemento e a foto de um local como cenário, com a ação escrita no prompt.

Mantenha um veículo ou produto consistente

Dê a um carro, um trailer ou um produto o seu próprio elemento, para que ele combine com a foto em todos os clipes.

Escale uma cena curta

Nomeie dois ou três elementos, diga como eles se encontram e acrescente um movimento de câmera.

# 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/reference-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "elements": [
      {
        "name": "example",
        "image_url": "https://example.com/reference.png"
      }
    ],
    "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.