PixVerse V6.0 / C1 · Referência da API
Gere vídeos PixVerse a partir de texto, imagens, quadros de início e fim ou referências.
Use pixverse-video-v6.0 ou pixverse-video-c1 como o ID do modelo. Envie JSON com uma chave de API APIMaster no cabeçalho Authorization: Bearer.
| Operação | Endpoint |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Quadros de início/fim | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| Status da tarefa | GET /v1/wand/pixverse/tasks/{task_id} |
| Campo | Tipo | Descrição |
|---|---|---|
model |
string | Obrigatório. Use um dos IDs do modelo acima. |
prompt |
string | Necessário, até caracteres 5,000. Os prompts de referência podem usar @ref_name. |
duration |
integer | 1–15 segundos, inclusive em 1080p. O padrão é 5 segundos. |
quality |
string | Obrigatório. 360p, 540p, 720p ou 1080p. |
aspect_ratio |
string | Text-to-video e reference-to-video apenas. 16:9 (padrão), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2 ou 21:9. Outras rotas seguem a imagem de entrada. |
seed |
integer | De 0 a 2,147,483,647. Omita o campo ou use 0 para escolher uma semente aleatória. |
generate_audio_switch |
boolean | Definir true para áudio. Valor padrão: false. |
camera_movement |
string | Movimento opcional como zoom_in, para text-to-video e image-to-video. |
generate_multi_clip_switch |
boolean | Opcional para V6.0 text-to-video e image-to-video. Valor padrão: false. |
img_id |
string | Necessário para image-to-video. Imagem pública URL ou Base64. |
img_ids |
string[] | Reservado para um modelo multi-imagem image-to-video. Um pedido padrão image-to-video usa img_id. |
first_frame_img, last_frame_img |
string | Necessário para pedidos de start/end-frame. Use o público URLs ou Base64. Use proporções de aspecto correspondentes. |
image_references |
object[] | Necessário para reference-to-video. Até sete itens com img_id, opcional type (subject ou background) e ref_name de até 30 caracteres. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Exigir ErrCode=0, bem como um status HTTP bem sucedido. A resposta contém ErrMsg, Resp.video_id e request_id. Poll cada segundo 3–5 com a mesma conta. Resp.status é 1 para o sucesso, 5 para processamento, 6 para excluído, 7 para falha de revisão de conteúdo e 8 para falha de geração. Resp.url é o download temporário final URL e dura até horas 12. A resposta também pode incluir dimensões, tamanho, semente, estilo e timestamps.
Consultar o status não inicia uma nova geração nem cobra outra vez. Use um Idempotency-Key de caracteres 8–128 visíveis ASCII para recuperar uma submissão. A mesma chave com os mesmos parâmetros retorna um recibo de recuperação com HTTP 202. Parâmetros diferentes com a mesma chave retornam HTTP 409. Ver Guia de recuperação de solicitações. A API não aceita um parâmetro de alerta negativo ou callback_url.
tokenhub_usage.total_tokens relata o uso faturável. A resolução e as configurações de áudio afetam o preço. Veja os cartões modelo PixVerse V6.0Z e PixVerse C1 para os preços atuais de APIMaster.
