Sobre o PixVerse V6 Effects
O PixVerse V6 Effects transforma uma foto, ou duas em alguns modelos, em um clipe curto com tema, a partir de 50 modelos de efeito prontos: comemorações esportivas, apresentações de produtos, danças, saudações e transformações. O modelo define o movimento e a duração; você escolhe de 360p a 1080p e se o clipe terá som.
Chame com o nome de modelo pixverse/v6-effects/image-to-video em POST /jobs/createTask, a partir de US$ 0,0222.
Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
generate_audio | Não | Adiciona som combinando com a imagem: vozes, ambiente e efeitos. Padrão: false |
image_urls | Sim | Fotos para editar ou combinar. Diga no prompt o que cada uma traz. |
preset | Sim | PixVerse effect template. It sets the clip length and the motion. 412736208886848 · 411563216524736 · 411316927927040 · 411174903569216 · 410999246341952 · 408891141511104 · 410317363057408 · 410285445698304 · 410133101388544 · 409899296377728 · 408897485909952 · 408869061406656 · 408661207662528 · 409767750265728 · 409766559675264 · 409589071559552 · 407804339389760 · 407658863287616 · 407474361215744 · 407473438360320 · 407467702283008 · 385844572217469 · 406428904874432 · 406423682060736 · 406411724685760 · 406372274350528 · 406218913317312 · 406218479198656 · 406064763308480 · 406413607395776 · 405662117814720 · 406014934000064 · 405658369331648 · 405321470423488 · 405175211454656 · 404955806201792 · 404820147974080 · 398980393937856 · 403916646846400 · 403739217192896 · 403560060358144 · 403556618212098 · 398965022284579 · 402201060373270 · 403085292466285 · 402061828030966 · 402888569901524 · 402155676592228 · 402047865383360 · 402046136040202 · Padrão: 398965022284579 |
prompt | Não | Optional nudge for the template. The template already defines the motion. |
resolution | Não | Tamanho de saída. Maior fica mais nítido e custa mais. 360p · 540p · 720p · 1080p · Padrão: 720p |
seed | Não | Repetir o mesmo número dá um resultado reproduzível. ≥ 0 · ≤ 2147483647 |
Preços
Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
| Opção | USD por segundo |
|---|---|
| generate_audio false · resolution 360p | US$ 0,0222 |
| generate_audio false · resolution 540p | US$ 0,0311 |
| generate_audio true · resolution 360p | US$ 0,0311 |
| generate_audio false · resolution 720p | US$ 0,04 |
| generate_audio true · resolution 540p | US$ 0,04 |
| generate_audio true · resolution 720p | US$ 0,0533 |
| generate_audio false · resolution 1080p | US$ 0,08 |
| generate_audio true · resolution 1080p | US$ 0,1022 |
Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.
Início rápido da API
Chame a API do PixVerse V6 Effects em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
- Envie a requisição. Faça POST /jobs/createTask com model pixverse/v6-effects/image-to-video e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "pixverse/v6-effects/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"preset": "398965022284579",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "720p"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do PixVerse V6 Effects
Quanto custa a API do PixVerse V6 Effects?
O PixVerse V6 Effects custa US$ 0,0222 por segundo. Preços por opção: false · 360p US$ 0,0222 por segundo, false · 540p US$ 0,0311 por segundo, true · 360p US$ 0,0311 por segundo, false · 720p US$ 0,04 por segundo. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
Qual é o nome de modelo do PixVerse V6 Effects na API?
Coloque pixverse/v6-effects/image-to-video para Imagem para vídeo no campo model de POST /jobs/createTask.
Em que o PixVerse V6 Effects difere do imagem para vídeo do PixVerse V6?
O Effects começa de um template: você escolhe um dos 50, envia uma foto, e o template define a duração e o movimento. O imagem para vídeo do PixVerse V6 começa do seu próprio prompt, deixa escolher a duração e aceita um último quadro. Use /models/pixverse-v6 quando quiser dirigir o clipe por conta própria.
Quanto dura o clipe e quanto tempo leva?
O template decide a duração; nosso clipe Knee Slide teve 5,04 segundos. Como cada template tem a sua duração, a reserva cobre o máximo de 30 segundos e libera a diferença na entrega. Esse clipe levou 36 segundos de geração em 540p, sem contar a fila nem a transferência; não medimos outros templates ou resoluções.
De que fotos eu preciso?
Uma foto para 47 dos templates, e duas fotos, uma para cada pessoa, para “Dive into the deep blue of love”, “Top of the World” e “The Last Hug”. JPG, JPEG, PNG ou WebP, de até 20 MB cada. Um retrato nítido, de estilo estúdio, funcionou no nosso teste.
Preciso escrever um prompt?
Não. O template já define o movimento, e se você deixar o prompt de fora, enviamos um padrão neutro. Uma frase curta que nomeie o momento é um empurrão, não um controle; não comparamos uma execução com prompt com uma sem prompt.
Quais são os limites da API do PixVerse V6 Effects?
Resoluções: 360p · 540p · 720p · 1080p; Imagens de referência: 2; Tamanho do prompt (caracteres): 5,000; Maior upload: 20 MB. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o PixVerse V6 Effects sem escrever código?
Execute PixVerse V6 Effects no Playground com seu saldo de API em USD, sem chave de API. Cada execução aparece no histórico de desenvolvedor com o código correspondente.
Todos os modelos PixVerse
O PixVerse V6 é a versão aberta: você escreve o seu próprio prompt e define a duração.
- API do PixVerse V6 MaxO topo da linha PixVerse: clipes em 1080p com som opcionalA partir de US$ 0,133 por um clipe de 5 segundos
- API do PixVerse V6 Effects50 modelos de efeito prontos que transformam uma foto em um clipe temáticoA partir de US$ 0,0222 por segundo
- API do PixVerse V6Clipes de 1 a 15 segundos em até 1080p, com referências e transiçõesA partir de US$ 0,111 por um clipe de 5 segundos