PixVerse V6 API
Gere transições entre quadros ou novas cenas a partir de imagens de referência, em 720p e com áudio nativo opcional.
- sem áudio
- APIMart $ 0,032 / segundo
- Oficial
$ 0,0420% mais barato - com áudio
- APIMart $ 0,04 / segundo
- Oficial
$ 0,053325% mais barato
Comparar preços
Compare os preços públicos dos canais para a mesma especificação de saída
Notas de preço
Cobrado pelo canal que de fato executa o job. O failover pode trocar de canal, o que pode mudar o custo e o tempo.
Usar a API
Deixe o código com um agente, gere direto no chat com MCP ou a Skill, ou integre você mesmo com o SDK ou a API compatível com OpenAI.
Deixe um agente de código fazer a integração
Copie o prompt de integração ou abra direto no Codex ou no Claude. O agente lê esta página e o contrato do modelo e depois escreve o envio, a espera e o tratamento do resultado no seu projeto.
Adicione o servidor MCP da Yir
Conecte ao ChatGPT, Claude ou Cursor, mencione @Yir e peça o PixVerse V6 pelo nome. Ele mostra o preço primeiro e só gera depois que você confirmar.
https://gateway.yir.ai/mcpUm comando para o Claude Code
Crie uma API key no console, defina como YIR_API_KEY e execute:
claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"Instale a Yir Skill
Defina YIR_API_KEY onde seu agente roda, adicione a Skill ao Claude Code, Codex ou outro agente de código e diga “use o PixVerse V6 na Yir para criar…”.
npx skills add yir-ai/skillsInstale o SDK oficial com seu gerenciador de pacotes ou copie o snippet abaixo para começar
| // Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL. |
| import { createNodeYirClient } from "@yir-ai/sdk/server"; |
| // Lê YIR_API_KEY do ambiente por padrão: process.env.YIR_API_KEY |
| const client = createNodeYirClient(); |
| // 1. Envia um job de geração de vídeo |
| const job = await client.submitVideo({ |
| model: "pixverse/pixverse-v6", |
| input: { |
| type: "image", |
| prompt: "Uma tartaruga marinha nada devagar sobre um recife de coral. A câmera acompanha suavemente pela lateral enquanto a luz do sol atravessa a água cristalina, projetando padrões em movimento no casco", |
| references: [{ role: "first_frame", ...{ url: "https://example.com/your-reference-image.png" } }], |
| }, |
| parameters: { |
| duration: 5, |
| resolution: "720p", |
| aspect_ratio: "auto", |
| generate_audio: false, |
| n: 1, |
| }, |
| }); |
| // 2. Aguarda o job terminar e entregar o resultado |
| const result = await client.waitForJob(job.id); |
| console.log("Arquivos entregues:", result.result); |
| if (result.result && "files" in result.result) { |
| for (const file of result.result.files) { |
| console.log("->", file.url); |
| } |
| } |
Projetos que já usam o protocolo da OpenAI, ou gateways como o new-api, só precisam de uma nova Base URL e key. Guia de compatibilidade com OpenAI
- base_url do SDK da OpenAI
https://gateway.yir.ai/openai/v1- Base URL do canal no new-api
https://gateway.yir.ai/openai- Key
- API Key do Yir
- ID do modelo
pixverse/pixverse-v6
# Replace https://example.com/your-reference-image.png with your publicly accessible HTTPS image URL.
curl https://gateway.yir.ai/openai/v1/videos \
-H "Authorization: Bearer $YIR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "pixverse/pixverse-v6",
"prompt": "Uma tartaruga marinha nada devagar sobre um recife de coral. A câmera acompanha suavemente pela lateral enquanto a luz do sol atravessa a água cristalina, projetando padrões em movimento no casco",
"resolution": "720p",
"aspect_ratio": "auto",
"input_reference": {
"image_url": "https://example.com/your-reference-image.png"
},
"seconds": "5"
}'Visão geral dos parâmetros
Parâmetros comuns; os limites dependem do modelo atual e do canal selecionado
- Resolução resolution
- 720p
Faixa de resolução da saída. Resoluções maiores dão mais nitidez e o preço acompanha
- Proporção aspect_ratio
- auto
Proporção geométrica. Escolha de acordo com o meio de destino (retrato, banner ou quadrado)
- Modo de entrada input_mode
- Entrada de imagem
- Entrada de referências
Os limites e formatos de referência dependem do modelo e do canal selecionado
- Duração duration
- 5 segundos
- 8 segundos
Faixa de duração da saída de vídeo, cobrada por segundo ou por faixa
- Áudio generate_audio
- Opcional
Faixa opcional de áudio nativo sincronizado
- Referências references
- first_frame ≤ 2
- last_frame ≤ 2
- reference_image ≤ 7
Os limites por modo dependem do canal escolhido. As quantidades na tabela são exemplos de preço, não limites nem cotas gratuitas.





