Conecte sua IA à Invision em 3 passos.

Ajuste e copie

Já deixamos tudo pronto. Mude só se quiser outro sistema ou modelo.

Depois de instalar, o Codex mostra o modelo qwen/qwen3.8-max-invision. O final "-invision" confirma que as chamadas passam pela Invision.

Dados do provedor

URL base

https://invision.dreamvision.com.br/v1 Copiar

Variável da chave

INVISION_API_KEY Copiar

Modelo

qwen/qwen3.8-max Copiar

Formatos

OpenAI (chat e responses), Anthropic (messages) e Gemini

1. Guarde sua chave

Ainda não tem chave? Crie uma no painel. Ela nunca entra no prompt copiado.

1setx INVISION_API_KEY "cole_sua_chave_aqui"
2# Feche e abra o terminal depois.

2. Teste a conexão

1curl.exe https://invision.dreamvision.com.br/v1/models -H "Authorization: Bearer $env:INVISION_API_KEY"

Configuração manual

1# %USERPROFILE%/.codex/config.toml
2model = "qwen/qwen3.8-max-invision"
3model_provider = "invision"
4
5[model_providers.invision]
6name = "Invision"
7base_url = "https://invision.dreamvision.com.br/v1"
8env_key = "INVISION_API_KEY"
9wire_api = "responses"
10
11[mcp_servers.invision]
12url = "https://invision.dreamvision.com.br/mcp"
13
14# ou pelo terminal:
15# codex mcp add invision --url https://invision.dreamvision.com.br/mcp

Se deu errado

• 401 invalid_api_key: a variável INVISION_API_KEY não existe ou está errada. No Windows, feche e abra o terminal depois do setx.
• 404: a URL base precisa terminar em /v1 (no Claude Code, use sem o /v1).
• model_not_found: use um ID exato da lista de modelos.
• O MCP não aparece: reinicie a ferramenta e confira se o endereço é exatamente https://invision.dreamvision.com.br/mcp.
• 402 insufficient_credit: recarregue o saldo no painel.

Uma chave, dezenas de modelos, pagamento em reais.

A Invision é uma API de modelos de linguagem compatível com o padrão da OpenAI. Você usa os mesmos SDKs e formatos que já conhece, acessa os principais modelos do mercado com uma única chave e paga por token, com recarga por Pix e sem mensalidade.

Toda requisição precisa do header Authorization: Bearer SUA_CHAVE_INVISION. Nunca coloque a chave em código que roda no navegador ou em aplicativos públicos.

1. Crie sua chave

1. Crie sua conta com e-mail ou Google.
2. No painel, faça uma recarga por Pix. O crédito cai em segundos.
3. Em Chaves de API, clique em Nova chave e copie o valor. Ele aparece uma única vez.
4. Guarde a chave em uma variável de ambiente, por exemplo INVISION_API_KEY.

2. Faça a primeira chamada

Com curl, direto no terminal:

1curl https://invision.dreamvision.com.br/v1/chat/completions \
2  -H "Authorization: Bearer $INVISION_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "qwen/qwen3.8-max",
6    "messages": [
7      { "role": "system", "content": "Você é um assistente objetivo." },
8      { "role": "user", "content": "Explique o que é uma API em uma frase." }
9    ]
10  }'

Resposta (resumida):

1{
2  "id": "chatcmpl-...",
3  "object": "chat.completion",
4  "model": "...",
5  "choices": [
6    { "index": 0,
7      "message": { "role": "assistant", "content": "Uma API é..." },
8      "finish_reason": "stop" }
9  ],
10  "usage": { "prompt_tokens": 24, "completion_tokens": 18, "total_tokens": 42 }
11}

O campo usage mostra exatamente quantos tokens foram cobrados.

3. Use com seu SDK favorito

Python

1pip install openai
2
3from openai import OpenAI
4import os
5
6client = OpenAI(base_url="https://invision.dreamvision.com.br/v1", api_key=os.environ["INVISION_API_KEY"])
7
8resp = client.chat.completions.create(
9    model="qwen/qwen3.8-max",
10    messages=[{"role": "user", "content": "Olá!"}],
11)
12print(resp.choices[0].message.content)

JavaScript / TypeScript

1npm install openai
2
3import OpenAI from "openai";
4
5const client = new OpenAI({
6  baseURL: "https://invision.dreamvision.com.br/v1",
7  apiKey: process.env.INVISION_API_KEY,
8});
9
10const resp = await client.chat.completions.create({
11  model: "qwen/qwen3.8-max",
12  messages: [{ role: "user", content: "Olá!" }],
13});
14console.log(resp.choices[0].message.content);

Ferramentas como LangChain, LlamaIndex, Vercel AI SDK, Cursor, Continue e n8n também funcionam: escolha o provedor “OpenAI compatível” e informe a URL base e a chave da Invision.

Endpoints

Parâmetros do chat

Principais campos aceitos por POST /v1/chat/completions:

Nem todo modelo aceita todos os campos. Consulte os recursos de cada um em GET /v1/models.

Streaming

Com "stream": true, a resposta chega em pedaços, no formato Server-Sent Events. Cada linha começa com data: e o fim é marcado por data: [DONE]. Ideal para chats, pois o usuário vê o texto sendo escrito.

1stream = client.chat.completions.create(
2    model="qwen/qwen3.8-max",
3    messages=[{"role": "user", "content": "Conte uma história curta."}],
4    stream=True,
5    stream_options={"include_usage": True},
6)
7for chunk in stream:
8    if chunk.choices and chunk.choices[0].delta.content:
9        print(chunk.choices[0].delta.content, end="", flush=True)

Ferramentas (function calling)

Descreva funções do seu sistema e o modelo decide quando chamá-las. Você executa a função e devolve o resultado numa mensagem com role: "tool".

1{
2  "model": "...",
3  "messages": [{ "role": "user", "content": "Qual o clima em São Paulo?" }],
4  "tools": [{
5    "type": "function",
6    "function": {
7      "name": "clima_atual",
8      "description": "Retorna o clima de uma cidade",
9      "parameters": {
10        "type": "object",
11        "properties": { "cidade": { "type": "string" } },
12        "required": ["cidade"]
13      }
14    }
15  }]
16}

Imagens (visão)

Modelos com visão aceitam imagens por URL pública ou em base64 dentro de content:

1"messages": [{
2  "role": "user",
3  "content": [
4    { "type": "text", "text": "O que tem nesta foto?" },
5    { "type": "image_url", "image_url": { "url": "https://exemplo.com/foto.jpg" } }
6  ]
7}]

Saída em JSON

Use "response_format": { "type": "json_object" } e peça JSON na mensagem de sistema. Para um formato exato, use json_schema com o esquema desejado.

Formato Anthropic

Quem já usa o SDK do Claude aponta para a Invision sem reescrever nada:

1from anthropic import Anthropic
2
3client = Anthropic(base_url="https://invision.dreamvision.com.br", api_key=os.environ["INVISION_API_KEY"])
4msg = client.messages.create(
5    model="...", max_tokens=512,
6    messages=[{"role": "user", "content": "Olá!"}],
7)

Modelos (62)

Use o ID exatamente como abaixo no campo model. Lista ao vivo (atualizada em 2026-09-22); também disponível em GET /v1/models, e os preços por token em Preços.

Cobrança e saldo

• Você paga por token de entrada (o que envia) e de saída (o que o modelo responde).
• Os preços são definidos em dólar e cobrados em reais pela cotação do dia.
• O débito acontece ao fim de cada requisição, com base no usage retornado.
• A conexão e a lista de modelos funcionam sem saldo. Ao tentar gerar uma resposta, a API retorna 402 insufficient_credit com a orientação para recarregar por Pix na Invision.
• Recarga por Pix, confirmada automaticamente. Sem mensalidade, sem valor mínimo mensal.

Limites

Cada conta tem um limite de requisições por minuto para garantir estabilidade. Ao atingi-lo, a API responde 429 com o header Retry-After. Precisa de mais? Fale com a gente.

Erros

Todo erro volta em JSON, em português, com um code fixo da Invision e o request_id da chamada (o mesmo do header X-Invision-Request-Id). Informe esse número ao suporte.

Tipo da falha nos cabeçalhos

Toda falha também informa, nos cabeçalhos, o tipo e a origem, para seu código decidir sozinho se tenta de novo:

• X-Invision-Error-Kind: auth (chave inválida), quota (sem saldo ou limite, não repita), rate_limit (espere o Retry-After), transient (instabilidade passageira, tente de novo) ou client (corrija a requisição).
• X-Invision-Error-Origin: account (sua conta), provider (fornecedor do modelo), request (sua requisição) ou invision.
• X-Invision-Retryable: true quando repetir pode resolver; nesse caso o Retry-After diz quantos segundos esperar.

Formato OpenAI (/v1/chat/completions, /v1/responses)

1{
2  "error": {
3    "message": "Chave Invision inválida.",
4    "type": "authentication_error",
5    "code": "invalid_api_key",
6    "param": null,
7    "doc_url": "https://invision.dreamvision.com.br/docs#erros"
8  },
9  "request_id": "9b1c…"
10}

Formato Anthropic (/v1/messages)

1{
2  "type": "error",
3  "error": { "type": "authentication_error", "message": "Chave Invision inválida." },
4  "request_id": "9b1c…"
5}

Use o campo code no seu programa, não o texto da mensagem: o texto pode mudar, o código não. Erros 429, 502, 503 e 504 podem ser repetidos com espera crescente; os demais precisam de correção antes.

Boas práticas

• Guarde a chave no servidor, nunca no navegador ou no app.
• Use uma chave por projeto; se vazar, revogue só aquela.
• Defina max_tokens para controlar custo.
• Em erros 429, 5xx e 504, tente de novo com espera crescente (1s, 2s, 4s…).
• Use streaming em respostas longas para evitar tempo esgotado.

Perguntas frequentes