Uma Chave, Dois Cabeçalhos, Oito Modelos: A API PixVerse AI Explicada

Dois desenvolvedores leram a documentação do PixVerse esta manhã. Um implementou um recurso de prompt negativo. O outro descobriu que esse parâmetro não existe mais.

Ambos estavam lendo páginas oficiais. Esse é o verdadeiro estado da API do PixVerse em 2026: um serviço de geração de vídeo capaz e em rápida evolução, envolto em uma documentação onde páginas antigas e novas discordam silenciosamente. A maioria das perguntas de desenvolvedores sobre a API PixVerse AI se resume a duas coisas. Onde estão os documentos que estão realmente atualizados? E quanto custará um clipe quando o código funcionar?

Este guia responde a ambas. Cada endpoint, parâmetro e preço abaixo foi verificado nas páginas oficiais nesta semana, em 23 de julho de 2026.

Principais Conclusões

• A documentação oficial da API PixVerse está em docs.platform.pixverse.ai. Chaves e créditos estão em platform.pixverse.ai. O aplicativo do consumidor em app.pixverse.ai é um produto separado com faturamento separado.
• Cada chamada precisa de dois cabeçalhos: API-KEY mais um UUID Ai-trace-id novo por requisição. A geração é assíncrona: envie, obtenha um video_id, faça polling pelo resultado.
• A documentação se contradiz em alguns lugares. Páginas de instruções mais antigas ainda mostram negative_prompt e water_mark; a referência de geração atual não tem nenhum dos dois. Quando as páginas discordarem, confie na referência do endpoint.
• O faturamento oficial é em créditos ($10 compram 1.000). O mesmo modelo V6 funciona medido no Atlas Cloud a partir de $0,025 por segundo, onde o clipe padrão de 5 segundos em 720p com áudio custa $0,30 contra $0,60 em créditos de pacote.

O Mapa da Documentação da API PixVerse: Onde Estão os Documentos Reais

Pesquisar pela documentação da API PixVerse retorna quatro superfícies oficiais e uma multidão de revendedores. As quatro que importam:

A divisão que confunde as pessoas é app versus plataforma. O app vende planos mensais a partir de $10 e distribui créditos gratuitos diários variáveis. A plataforma vende créditos de API e assinaturas em um livro separado. Uma assinatura paga do app não lhe dá nada no lado da API, e vice-versa.

Um detalhe genuinamente útil está escondido na documentação da plataforma: uma página de texto simples consolidada chamada PixVerse-api-llm.txt que compila toda a referência da API em um único documento. Cole-a no seu assistente de codificação e ele poderá escrever chamadas PixVerse com base nas especificações atuais, em vez do que quer que seus dados de treinamento lembrem.

A documentação descreve um serviço com "mais de 100 milhões de criadores e empresas em 175 países." A escala é real. A rotatividade de versões que a acompanha é a razão pela qual este artigo tem uma seção de contradições.

Duas Maneiras de Usar a API PixVerse AI Hoje

A integração com a própria plataforma do PixVerse recebe uma explicação completa na próxima seção. A maneira mais rápida de testar os modelos primeiro é através de um host: o Atlas Cloud executa o PixVerse V6 e C1 entre seus mais de 400 modelos, cobrado por segundo em dólares, sem pacotes de crédito e sem marca d'água. A página da família PixVerse lista todos os nove endpoints hospedados, desde texto para vídeo até referência para vídeo e extensão. Duas formas de acessar: teste no playground, depois chame o mesmo endpoint a partir do código. O ponto de partida natural é o playground de texto para vídeo V6.

Método 1: Teste a API PixVerse V6 no Playground

Antes de escrever código, passe dez minutos aqui. O playground é o mesmo endpoint que seu código chamará, com um orçamento anexado.

1. Faça login e abra o playground. O campo de prompt é a única entrada obrigatória.
2. Defina duração, qualidade e proporção. Os padrões são 5 segundos, 720p, 16:9.
3. Verifique a alternância de áudio. O som está ativado por padrão e aumenta a taxa por segundo.
4. Leia o botão Executar. Ele mostra o custo exato das suas configurações atuais. Nos padrões, isso é $0,30, então $10 cobre cerca de 33 execuções.
5. Execute, revise, baixe. Itere no prompt até que a saída seja satisfatória, então mova essa configuração exata para o código.

Método 2: Chame a API PixVerse V6 a partir do Código

O fluxo de trabalho do desenvolvedor PixVerse V6 no Atlas Cloud consiste em duas requisições HTTP.

Passo 1: Obtenha sua chave de API. Crie uma chave no console do Atlas Cloud e armazene-a como uma variável de ambiente, nunca no código do cliente.

Imagem: Captura de tela da página de chaves de API do console do Atlas Cloud, mostrando o botão de criar chave e uma chave recém-gerada ao lado do controle de cópia.

Passo 2: Verifique a documentação da API. Endpoints, parâmetros e autenticação estão na documentação da API.

Passo 3: Faça sua primeira requisição. Envie o trabalho:

plaintextCopy
1curl -X POST https://api.atlascloud.ai/api/v1/model/generateVideo \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer $ATLASCLOUD_API_KEY" \
4  -d '{
5    "model": "pixverse/v6/text-to-video",
6    "prompt": "Um movimento lento de dolly através de um mercado noturno molhado pela chuva, letreiros de neon refletindo em poças, vapor subindo de barracas de comida",
7    "duration": 5,
8    "quality": "720p",
9    "aspect_ratio": "16:9",
10    "sound": true
11  }'

A resposta retorna um ID de predição. Faça polling até que o status seja completed:

plaintextCopy
1curl https://api.atlascloud.ai/api/v1/model/prediction/<prediction_id> \
2  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

A resposta concluída carrega a URL do vídeo hospedado. O benefício duradouro é a forma da requisição: o Atlas Cloud executa uma API em todos os modelos, então uma chave, um cabeçalho de autenticação e um loop de envio e polling cobrem o PixVerse hoje e o que você adicionar depois. Trocar de modelos significa alterar a string do modelo, nada mais.

Dentro da Documentação Oficial da API PixVerse AI: Como uma Chamada Realmente Funciona

Se você integrar com a própria plataforma do PixVerse, a visão geral da API define um fluxo de três estágios contra o domínio base app-api.pixverse.ai:

A autenticação requer dois cabeçalhos em cada chamada. API-KEY contém a chave do seu console da plataforma. Ai-trace-id deve ser um UUID novo por requisição; a documentação adverte que reutilizar um impede o início de novas gerações.

A referência atual de texto para vídeo marca cinco campos como obrigatórios: prompt (até 5.000 caracteres), model, duration, quality e aspect_ratio. O enum model aceita oito valores, v3.5 até v5.6 mais v6 e c1, e os limites de duração seguem a geração: 5 ou 8 segundos até v5, uma opção de 10 segundos no v5.5 e v5.6, e qualquer 1 a 15 segundos no v6 e c1. O áudio é opt-in através de generate_audio_switch, que tem como padrão false. Esse padrão importa para o orçamento: o playground do Atlas Cloud acima ativa o som por padrão, então as duas rotas citam preços diferentes para o que parece ser o mesmo clipe.

Imagem para vídeo adiciona o passo de upload primeiro. Não há como passar uma URL de imagem pública; você faz upload do arquivo, pega o img_id retornado e o referencia no corpo da geração.

Dois fatos operacionais completam o quadro, ambos da referência de erros. As gerações simultâneas são limitadas pelo nível de assinatura, e um slot travado se libera após cerca de 10 minutos. E os status de polling merecem tratamento explícito: 7 significa que o prompt acionou a moderação de conteúdo, 8 significa uma falha no lado do servidor que vale a pena tentar novamente.

Onde a Documentação da API PixVerse se Contradiz

A documentação da API PixVerse é uma mistura de referências de endpoint atuais e páginas de instruções mais antigas que nunca foram totalmente atualizadas. Ler a página errada custa tempo real de depuração. Os conflitos que verificamos diretamente:

Duas regras cobrem todas as cinco linhas. Quando as páginas discordarem, confie na referência do endpoint em vez da página de instruções; as referências carregam especificações atuais, os guias carregam histórico. E quando os limites discordarem, codifique para o mais restritivo, então 4000 pixels nos uploads.

O enum de versão merece seu próprio aviso. Nomes de modelos antigos ainda funcionam: v3.5, v4 e v4.5 continuam sendo valores válidos, então integrações de 2025 não quebraram. Eles apenas pagam mais. Em 720p por 5 segundos sem áudio, a precificação oficial cobra 60 créditos no V4, mas 45 no V6. Se você herdar uma base de código com uma string de modelo antiga, atualizá-la é uma mudança de uma linha que reduz o custo e melhora a saída. Apenas a geração V2 desapareceu do acesso oficial completamente.

Precificação da API PixVerse: Créditos na Plataforma, Dólares no Atlas Cloud

A plataforma oficial do PixVerse cobra em créditos, e sua página de precificação rotula as tabelas de modelo como "Calculado por segundo." Os pacotes de crédito vão de $10 por 1.000 créditos a $5.000 por 500.000, com assinaturas mensais a partir do plano Essential de $100 (15.000 créditos) até um nível Business de $6.000. O consumo de crédito por segundo para os modelos atuais:

O Atlas Cloud mede os mesmos dois modelos em dólares por segundo, sem pacote ou assinatura primeiro. Verificado nas páginas de modelo ao vivo em 23 de julho de 2026, a preço de tabela sem desconto em execução:

Um clipe torna a comparação concreta. Um clipe V6 de 5 segundos em 720p com áudio custa 60 créditos: isso é $0,60 na taxa do pacote de $10, ou cerca de $0,40 na taxa de assinatura Essential após comprometer $100 pelo mês. Medido no Atlas Cloud, o clipe idêntico é $0,30. O modelo C1 tem preços ligeiramente mais altos por segundo, $0,325 para esse mesmo clipe através do playground C1, o que compra seu ajuste de produção cinematográfica.

Créditos ainda fazem sentido para equipes que já estão dentro da plataforma do PixVerse, especialmente no volume do nível Scale onde a taxa efetiva diminui. Para todos os outros, a precificação em dólares por segundo é mais fácil de prever: o preço de uma renderização é duração vezes taxa, legível antes de gastar.

A Empresa Desenvolvedora da PixVerse AI por Trás da API

Uma API é uma aposta na empresa que a opera, e a empresa desenvolvedora da PixVerse AI vale a pena conhecer antes de construir. PixVerse é construído pela AISphere (Aishi Technology), fundada em abril de 2023 em Pequim e agora sediada em Cingapura com cerca de 150 funcionários. O fundador e CEO Wang Changhu liderou o trabalho de visão do AI Lab da ByteDance de 2017 a 2021, o que torna a PixVerse uma rival direta do Seedance, construído por seu ex-empregador. O cofundador Jaden Xie veio da Lighthouse Capital.

O quadro de financiamento é excepcionalmente forte para uma loja independente de modelos de vídeo. Em 13 de julho de 2026, a empresa fechou uma extensão da Série C elevando a rodada para $439 milhões com uma avaliação acima de $2 bilhões, com a Alibaba participando, segundo o TechCrunch. Para um desenvolvedor, isso soa como pista: a API que você integra neste trimestre provavelmente não desaparecerá no próximo ano.

O outro lado de um laboratório bem financiado é a velocidade de lançamento. A linha de lançamentos de 2026 sozinha:

Três lançamentos de modelos em três meses explicam o atraso na documentação que este artigo continua destacando. Construa de acordo: fixe sua string de modelo, leia as notas de lançamento antes de alterá-la e verifique novamente a referência do endpoint em vez de assumir que os parâmetros do trimestre passado sobreviveram.

Perguntas Frequentes

Onde está a documentação oficial da API PixVerse?

Em docs.platform.pixverse.ai, com o console do desenvolvedor em platform.pixverse.ai. Qualquer coisa hospedada em app.pixverse.ai é o produto do consumidor, e páginas de terceiros "documentação da API PixVerse" frequentemente descrevem parâmetros da era v4. A documentação também inclui uma página de texto consolidada pronta para LLM que você pode alimentar para um assistente de codificação.

Como obtenho uma chave de API PixVerse?

Registre-se no console da plataforma em platform.pixverse.ai, crie uma chave e passe-a no cabeçalho API-KEY junto com um UUID Ai-trace-id único por requisição. As chaves estão vinculadas aos créditos da plataforma, que são comprados separadamente de qualquer assinatura do aplicativo do consumidor. No Atlas Cloud, o equivalente é uma chave do console passada como um token Bearer padrão.

A API PixVerse tem um nível gratuito?

A documentação de precificação da plataforma lista apenas pacotes de crédito e assinaturas pagas. Os créditos gratuitos diários variáveis que a PixVerse anuncia pertencem ao aplicativo do consumidor e não fluem para o livro da API. Os pontos de entrada pagos mais baratos são um pacote de crédito de $10 na plataforma oficial ou geração medida a partir de $0,025 por segundo no Atlas Cloud.

Quais modelos a API PixVerse pode executar?

O endpoint de geração atual aceita oito valores de modelo: v3.5, v4, v4.5, v5, v5.5, v5.6, v6 e c1. V6 e C1 são a geração atual, com clipes de 1 a 15 segundos e áudio nativo opcional. Nomes mais antigos ainda funcionam, mas custam mais créditos nas mesmas configurações do que o V6. A geração V2 não está mais disponível oficialmente.

Quanto custa a API PixVerse AI por vídeo?

Plataforma oficial: um clipe V6 de 5 segundos em 720p com áudio custa 60 créditos, cerca de $0,60 na taxa do pacote de $10. Atlas Cloud: o mesmo clipe é $0,30 medido, a partir de uma faixa por segundo de $0,025 a $0,115 dependendo da resolução e áudio. O C1 custa ligeiramente mais, $0,325 para esse clipe. Preços verificados em 23 de julho de 2026.

Conclusão

A API PixVerse está em melhor forma do que sua documentação. O serviço em si é rápido, bem financiado e atual: oito valores de modelo, clipes de até 15 segundos, áudio na mesma passagem e um fluxo assíncrono que qualquer desenvolvedor júnior pode configurar em uma tarde. A documentação simplesmente não acompanhou o calendário de lançamentos, então as referências de endpoint e os guias de instruções descrevem produtos diferentes.

O método de trabalho é simples. Confie na referência do endpoint, codifique para o limite mais restritivo quando as páginas discordarem e fixe sua string de modelo. Então escolha sua forma de faturamento: créditos na plataforma oficial se sua equipe já estiver lá, ou dólares por segundo a partir de $0,025 se você quiser o preço de cada renderização legível antes de enviá-la. O clipe padrão de $0,30 no playground é um lugar barato para descobrir de que lado você está.