Visão geral
O que é a Invision
Uma API única para os principais modelos de IA. Ela aceita os formatos OpenAI, Anthropic e Google Gemini, então o seu código continua igual: troque a URL base e use a chave da Invision.
- URL base
https://invision.dreamvision.com.br/v1- SDK da Anthropic
https://invision.dreamvision.com.br(sem /v1)- Chave
inv_live_…, guardada na variávelINVISION_API_KEY- Cobrança
- Por token de entrada e de saída, descontado do saldo da conta
Por dentro
Como funciona
Cada pedido passa pelo gateway da Invision antes de chegar ao modelo. Você não muda o formato do seu código: o gateway entende o formato que chegou e devolve a resposta no mesmo formato.
Seu código
Usa o SDK oficial da OpenAI, da Anthropic ou do Google. Só mudam a URL base e a chave.
A Invision confere
Chave, plano e saldo. Pedido sem saldo para aqui e não custa nada.
Melhor rota
O mesmo modelo oficial, pela rota mais barata disponível naquele momento.
Resposta e débito
A resposta volta no formato que você usou. O débito sai do usage, token por token.
Pedido que falhou antes de chegar ao modelo não é cobrado. Se a rota mais barata cair, a Invision tenta a próxima sozinha.
Em 2 minutos
Primeira chamada
Crie a conta e escolha um plano
O valor do plano vira saldo para usar na API.
Crie uma chave
Em Chaves de API. Ela aparece uma vez só: guarde em um lugar seguro.
Faça a chamada
Use o exemplo abaixo com a sua chave na variável de ambiente.
curl https://invision.dreamvision.com.br/v1/chat/completions \
-H "Authorization: Bearer $INVISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen3.8-max",
"messages": [{"role": "user", "content": "Olá"}]
}'
Quer testar a chave sem gastar? GET /v1/models não desconta saldo. Criar uma chave.
Referência
Autenticação
A mesma chave vale nos três formatos. Muda só o cabeçalho e, no SDK da Anthropic, a URL base.
| Formato | Cabeçalho | URL base no SDK |
|---|---|---|
| OpenAI | Authorization: Bearer SUA_CHAVE | https://invision.dreamvision.com.br/v1 |
| Anthropic | x-api-key: SUA_CHAVE | https://invision.dreamvision.com.br |
| Gemini | Authorization: Bearer SUA_CHAVE | https://invision.dreamvision.com.br/v1 |
No formato Anthropic, envie também anthropic-version: 2023-06-01. Nunca coloque a chave em código que roda no navegador nem em um repositório.
Referência
Endpoints
Todos ficam em /v1 e usam a mesma chave. Toque em um endpoint para ver o exemplo.
Formato OpenAI. Conversa com mensagens, ferramentas, imagens e saída em JSON.
curl https://invision.dreamvision.com.br/v1/chat/completions \
-H "Authorization: Bearer $INVISION_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen3.8-max",
"messages": [{"role": "user", "content": "Olá"}]
}'
“Grátis” quer dizer que o endpoint não gera texto e não desconta saldo. Use-os para testar a chave.
Ao vivo
Modelos e IDs
A lista oficial vem de GET /v1/models. Use o ID exatamente como aparece. Toque em um modelo para copiar o ID.
Atualizado em 2026-09-22. Ver todos os modelos e preços.
Versão Invision
IDs com final -invision têm desconto. O mesmo ID sem o final é atendido igual, pelo mesmo preço.
Escolha automática
invision/auto escolhe o modelo mais barato que resolve cada pedido.
Camada rápida
O final -fast responde mais rápido e custa o dobro da tabela oficial.
Recursos
Streaming, ferramentas e JSON
Os recursos dos SDKs oficiais funcionam do mesmo jeito. Os exemplos usam o formato OpenAI.
Envie "stream": true. Cada linha começa com data: e o fim é data: [DONE]. Com stream_options.include_usage, o consumo chega no último evento.
stream = client.chat.completions.create(
model="qwen/qwen3.8-max",
messages=[{"role": "user", "content": "Conte uma história curta"}],
stream=True,
stream_options={"include_usage": True},
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
Referência
Cabeçalhos de resposta
Toda resposta traz cabeçalhos da Invision para você rastrear o pedido.
| Cabeçalho | O que diz |
|---|---|
X-Invision-Request-Id | ID do pedido (também em x-request-id). Mande para o suporte se algo der errado. |
X-Invision-Model | O ID do modelo que atendeu o pedido. |
X-Invision-Cache | hit quando a resposta veio do cache da Invision. |
X-Invision-Fast | on quando o pedido usou a camada rápida. |
X-Invision-Error-Code | O mesmo code do corpo do erro. |
X-Invision-Error-Kind | auth, quota, rate_limit, transient ou client. |
X-Invision-Error-Origin | account, request, provider ou invision. |
X-Invision-Retryable | true quando vale repetir; respeite o Retry-After. |
Quando algo dá errado
Erros
Todo erro volta em JSON com um code fixo e o request_id. Os cabeçalhos X-Invision-Error-Kind e X-Invision-Retryable dizem se vale repetir.
| HTTP | Código | O que fazer |
|---|---|---|
| 400 | invalid_request | Corpo malformado. O campo com problema vem em param. |
| 400 | context_length_exceeded | Conversa acima do contexto do modelo. Corte o histórico. |
| 401 | invalid_api_key | Chave ausente, errada ou revogada. |
| 402 | insufficient_credit | Sem saldo. Recarregue no painel; não repita. |
| 402 | key_budget_exceeded | A chave bateu o limite mensal definido por você. |
| 403 | phone_verification_required | A conta precisa confirmar o celular em /confirmar-celular antes de usar a API. |
| 403 | api_plan_required | A conta não tem um plano com API. Assine um plano (a partir do Plus); o valor vira saldo. |
| 404 | model_not_found | ID fora do catálogo. Use GET /v1/models. |
| 413 | payload_too_large | Pedido acima de 25 MB. |
| 429 | rate_limited | Mais de 120 pedidos por minuto. Espere o Retry-After. |
| 502 | upstream_unavailable | Instabilidade passageira do modelo. Repita com espera. |
| 504 | upstream_timeout | O modelo demorou demais. Use streaming. |
Referência
Limites
pedidos por minuto por chave. Acima disso, 429 com Retry-After.
por pedido, imagens em base64 incluídas.
limite opcional por chave, definido por você no painel.
Conta
Chaves de API
- Crie quantas quiser em Chaves de API: uma por projeto ajuda a ver o consumo de cada um.
- A chave aparece uma vez só. Perdeu? Revogue e crie outra.
- Cada chave pode ter um limite mensal. Ao bater o limite, a API responde
402 key_budget_exceeded. - Chave apagada ou errada responde
401 invalid_api_key: crie uma nova e troque onde ela estava.
Configurou o Codex ou o Claude Code pelo terminal? Troque a chave com um comando
O comando pede a chave nova sem mostrá-la na tela e troca só a chave, sem mexer no resto.
irm https://invision.dreamvision.com.br/cli/trocar-chave.ps1 | iex
Conta
Cobrança e saldo
Plano vira saldo
Para usar a API, a conta precisa de um plano. O valor do plano vira saldo integral, em reais.
Débito exato
Cada pedido desconta do saldo pelo usage: tokens de entrada e de saída.
Falhou, não paga
Pedido que não chegou ao modelo não custa nada.
Sem saldo
A API responde 402 insufficient_credit. Recarregue a partir de R$ 5 no painel.
Codex e Claude
Use o Aplicativo Invision
Para ligar o Codex ou o app Claude para computador à Invision, você não precisa editar arquivo nem colar prompt.
Instale, cole o código de ativação e pronto
O aplicativo configura a ferramenta sozinho e deixa todos os modelos da Invision na lista. Funciona no Windows, no Mac e no Linux.
Para IAs
Para IAs e MCP
Referência completa
Um texto só, feito para IAs lerem, com a lista viva de modelos: https://invision.dreamvision.com.br/llms-full.txt
Servidor MCP
https://invision.dreamvision.com.br/mcp. Sem chave e só de leitura: a IA consulta a documentação, os modelos e os preços. Quem gera as respostas é a API.
Dúvidas
Perguntas frequentes
Preciso mudar meu código?
Na maioria dos casos, só a URL base e a chave. Teste os recursos que você usa antes de migrar tudo.
A Invision é o InVision de design?
Não. O InVision era uma ferramenta de design já encerrada. A Invision é a API de modelos de IA da Dream Vision.
Preciso de um plano para usar a API?
Sim. O valor do plano vira saldo integral. Depois, a recarga é a partir de R$ 5.
Pedido que falhou é cobrado?
Não. Pedido que não chegou ao modelo não custa nada.
Posso ter várias chaves?
Sim. Uma por projeto, cada uma com limite mensal opcional e revogação a qualquer momento.
Onde vejo o consumo?
No painel, em Consumo: modelo, tokens e valor de cada pedido.
Onde verifico a política de dados?
Em Privacidade, Termos e LGPD, no rodapé do site.