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:

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": "system", "content": "Você é um assistente objetivo." },
      { "role": "user", "content": "Explique o que é uma API em uma frase." }
    ]
  }'

Resposta (resumida):

{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "...",
  "choices": [
    { "index": 0,
      "message": { "role": "assistant", "content": "Uma API é..." },
      "finish_reason": "stop" }
  ],
  "usage": { "prompt_tokens": 24, "completion_tokens": 18, "total_tokens": 42 }
}

O campo usage mostra exatamente quantos tokens foram cobrados.

3. Use com seu SDK favorito

Python

pip install openai

from openai import OpenAI
import os

client = OpenAI(base_url="https://invision.dreamvision.com.br/v1", api_key=os.environ["INVISION_API_KEY"])

resp = client.chat.completions.create(
    model="qwen/qwen3.8-max",
    messages=[{"role": "user", "content": "Olá!"}],
)
print(resp.choices[0].message.content)

JavaScript / TypeScript

npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://invision.dreamvision.com.br/v1",
  apiKey: process.env.INVISION_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "qwen/qwen3.8-max",
  messages: [{ role: "user", content: "Olá!" }],
});
console.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.

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="", 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".

{
  "model": "...",
  "messages": [{ "role": "user", "content": "Qual o clima em São Paulo?" }],
  "tools": [{
    "type": "function",
    "function": {
      "name": "clima_atual",
      "description": "Retorna o clima de uma cidade",
      "parameters": {
        "type": "object",
        "properties": { "cidade": { "type": "string" } },
        "required": ["cidade"]
      }
    }
  }]
}

Imagens (visão)

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

"messages": [{
  "role": "user",
  "content": [
    { "type": "text", "text": "O que tem nesta foto?" },
    { "type": "image_url", "image_url": { "url": "https://exemplo.com/foto.jpg" } }
  ]
}]

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:

from anthropic import Anthropic

client = Anthropic(base_url="https://invision.dreamvision.com.br", api_key=os.environ["INVISION_API_KEY"])
msg = client.messages.create(
    model="...", max_tokens=512,
    messages=[{"role": "user", "content": "Olá!"}],
)

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.
• Sem saldo, a API responde 402 insufficient_credit até a próxima recarga.
• 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

Erros sempre voltam em JSON:

{ "error": { "type": "invalid_api_key", "code": "invalid_api_key", "message": "Chave Invision inválida." } }

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