Pular para o conteúdo

Conecte suas ferramentas ao Fluxo

Todos os clientes usam o host da API https://api.fluxorelay.com. O domínio do site não responde a chamadas de API.

VS Code

O Claude Code para VS Code usa a mesma CLI por baixo, então lê as duas variáveis abaixo do ambiente em que o VS Code foi iniciado.

export ANTHROPIC_BASE_URL=https://api.fluxorelay.com
export ANTHROPIC_AUTH_TOKEN=flx_your_key_here
claude

A extensão do Codex lê ~/.codex/config.toml, o mesmo arquivo usado pela CLI do Codex; a seção de terminal abaixo tem uma versão pronta para copiar.

Extensões com um provedor “compatível com OpenAI” (Cline, Roo Code, Continue) precisam de três campos: URL base https://api.fluxorelay.com/v1, sua chave do Fluxo e um ID de modelo da página de preços.

Base URL : https://api.fluxorelay.com/v1
API key  : flx_your_key_here
Model    : gpt-6.1-sol

IDEs da JetBrains

O plugin do Claude Code executa a CLI no terminal da IDE: adicione os dois comandos export ao perfil do seu shell e reinicie a IDE para que ela herde as variáveis.

Plugins de assistente que aceitam um endpoint personalizado da OpenAI usam https://api.fluxorelay.com/v1 como URL e sua chave do Fluxo como token.

Cursor

Nas configurações de modelos do Cursor, cole sua chave do Fluxo como chave da API da OpenAI, ative a substituição da URL base e defina https://api.fluxorelay.com/v1. Depois, adicione os IDs dos modelos que quiser, como gpt-6.1-sol.

Os modelos Claude não ficam acessíveis pela substituição da URL da OpenAI no Cursor; use o Claude Code para eles (veja a nota na seção de terminal).

Terminal

Agentes de linha de comando leem as configurações do ambiente ou de um arquivo oculto. Abaixo, um arquivo para cada ferramenta.

Claude Code e Claude Desktop

Defina duas variáveis de ambiente e execute claude. A URL base não leva o sufixo /v1.

export ANTHROPIC_BASE_URL=https://api.fluxorelay.com
export ANTHROPIC_AUTH_TOKEN=flx_your_key_here
claude

Versão para PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.fluxorelay.com"
$env:ANTHROPIC_AUTH_TOKEN = "flx_your_key_here"
claude

Os modelos Claude estão disponíveis apenas nos clientes oficiais Claude Code e Claude Desktop, na versão 2.1.285 ou superior. Essa restrição vem do provedor de origem. GPT, Gemini e todas as outras famílias funcionam em qualquer cliente ou SDK compatível com OpenAI.

Codex CLI

O Codex lê ~/.codex/config.toml. A linha env_key indica a variável que contém sua chave do Fluxo.

.codex/config.toml

# ~/.codex/config.toml  (Codex CLI and the Codex IDE extension both read it)
model = "gpt-5.6-sol"        # or any other GPT id from the Fluxo price list
model_provider = "fluxo"

[model_providers.fluxo]
name = "Fluxo relay"
base_url = "https://api.fluxorelay.com/v1"
env_key = "FLUXO_API_KEY"   # export FLUXO_API_KEY=flx_... before launching codex
wire_api = "responses"       # Fluxo passes /v1/responses straight through
export FLUXO_API_KEY=flx_your_key_here
codex   # reads ~/.codex/config.toml

Gemini CLI e a API do Gemini

Defina GOOGLE_GEMINI_BASE_URL com o host da API, sem acrescentar /v1beta, e coloque sua chave em GEMINI_API_KEY. Depois, execute gemini.

export GOOGLE_GEMINI_BASE_URL=https://api.fluxorelay.com
export GEMINI_API_KEY=flx_your_key_here
gemini
curl "https://api.fluxorelay.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: flx_your_key_here" \
  -H 'Content-Type: application/json' \
  --data-raw '{"contents":[{"role":"user","parts":[{"text":"ping from my editor"}]}]}'

No Fluxo, o Gemini usa apenas seu protocolo nativo. Para streaming, use :streamGenerateContent?alt=sse; /v1/chat/completions não aceita modelos Gemini.

Identificadores dos modelos Gemini:

  • gemini-3.1-pro
  • gemini-3.8-flash
  • gemini-4-argon

cURL direto do terminal

Use https://api.fluxorelay.com/v1 como base_url e sua chave do Fluxo como api_key. As chamadas de chat usam /v1/chat/completions.

curl https://api.fluxorelay.com/v1/chat/completions \
  -H "Authorization: Bearer flx_your_key_here" \
  -H 'Content-Type: application/json' \
  --data-raw '{"model":"gpt-6.1-sol","messages":[{"role":"user","content":"ping from my editor"}]}'

Modelos GPT para testar primeiro:

  • gpt-6.1-sol
  • gpt-6-astra
  • gpt-5.6-sol

Chaves, erros e cobrança

Chamadas no formato OpenAI enviam a chave como token Bearer. No formato Anthropic, a chave vai em x-api-key. Chamadas Gemini usam x-goog-api-key.

Cada chamada é cobrada com base na contagem de tokens informada pelo provedor. HTTP 402 significa que seus créditos acabaram ou que a franquia do passe se esgotou: recarregue e tente novamente.