Docs
Referência da API

Uma chave. Todos os modelos.

A Invision é um gateway de IA. Aponte o SDK oficial da OpenAI, da Anthropic ou do Google para a Invision e use Claude, GPT, Gemini e outros com uma chave só, pagando menos que a tabela oficial.

URL basehttps://invision.dreamvision.com.br/v1
Exemplo · não usa saldo
POST https://invision.dreamvision.com.br/v1/chat/completions
Authorization: Bearer $INVISION_API_KEY

{
  "model": "qwen/qwen3.8-max",
  "stream": true,
  "messages": [{ "role": "user", "content": "Olá" }]
}
pronto para enviar

A resposta aparece aqui, em streaming.

modelos ao vivo
62modelos ao vivo
formatos: OpenAI, Anthropic e Gemini
3formatos: OpenAI, Anthropic e Gemini
endpoints
7endpoints
pedidos por minuto por chave
120pedidos por minuto por chave
Navegar na documentação

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ável INVISION_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.

  1. Seu código

    Usa o SDK oficial da OpenAI, da Anthropic ou do Google. Só mudam a URL base e a chave.

  2. A Invision confere

    Chave, plano e saldo. Pedido sem saldo para aqui e não custa nada.

  3. Melhor rota

    O mesmo modelo oficial, pela rota mais barata disponível naquele momento.

  4. 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

  1. Crie a conta e escolha um plano

    O valor do plano vira saldo para usar na API.

  2. Crie uma chave

    Em Chaves de API. Ela aparece uma vez só: guarde em um lugar seguro.

  3. 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.

FormatoCabeçalhoURL base no SDK
OpenAIAuthorization: Bearer SUA_CHAVEhttps://invision.dreamvision.com.br/v1
Anthropicx-api-key: SUA_CHAVEhttps://invision.dreamvision.com.br
GeminiAuthorization: Bearer SUA_CHAVEhttps://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.

Python
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çalhoO que diz
X-Invision-Request-IdID do pedido (também em x-request-id). Mande para o suporte se algo der errado.
X-Invision-ModelO ID do modelo que atendeu o pedido.
X-Invision-Cachehit quando a resposta veio do cache da Invision.
X-Invision-Faston quando o pedido usou a camada rápida.
X-Invision-Error-CodeO mesmo code do corpo do erro.
X-Invision-Error-Kindauth, quota, rate_limit, transient ou client.
X-Invision-Error-Originaccount, request, provider ou invision.
X-Invision-Retryabletrue 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.

HTTPCódigoO que fazer
400invalid_requestCorpo malformado. O campo com problema vem em param.
400context_length_exceededConversa acima do contexto do modelo. Corte o histórico.
401invalid_api_keyChave ausente, errada ou revogada.
402insufficient_creditSem saldo. Recarregue no painel; não repita.
402key_budget_exceededA chave bateu o limite mensal definido por você.
403phone_verification_requiredA conta precisa confirmar o celular em /confirmar-celular antes de usar a API.
403api_plan_requiredA conta não tem um plano com API. Assine um plano (a partir do Plus); o valor vira saldo.
404model_not_foundID fora do catálogo. Use GET /v1/models.
413payload_too_largePedido acima de 25 MB.
429rate_limitedMais de 120 pedidos por minuto. Espere o Retry-After.
502upstream_unavailableInstabilidade passageira do modelo. Repita com espera.
504upstream_timeoutO modelo demorou demais. Use streaming.

Referência

Limites

120

pedidos por minuto por chave. Acima disso, 429 com Retry-After.

25 MB

por pedido, imagens em base64 incluídas.

Mensal

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.

Ver planos e preços.

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.

Pegar o aplicativo

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.