Saltar al contenido

Conecta tus herramientas a Fluxo

Todos los clientes se conectan al host de la API: https://api.fluxorelay.com. El dominio del sitio web no responde a llamadas a la API.

VS Code

Claude Code para VS Code usa la misma CLI, por lo que toma las dos variables de abajo del entorno desde el que se inició VS Code.

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

La extensión de Codex lee ~/.codex/config.toml, el mismo archivo que usa la CLI de Codex; en la sección de terminal de abajo tienes una versión lista para copiar.

Las extensiones con un proveedor «compatible con OpenAI» (Cline, Roo Code, Continue) necesitan tres datos: la URL base https://api.fluxorelay.com/v1, tu clave de Fluxo y un ID de modelo de la página de precios.

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

IDE de JetBrains

El plugin de Claude Code ejecuta la CLI en la terminal del IDE: agrega los dos comandos export al perfil de tu shell y reinicia el IDE para que herede esas variables.

En los plugins de asistente que admiten un endpoint personalizado de OpenAI, usa https://api.fluxorelay.com/v1 como URL y tu clave de Fluxo como token.

Cursor

En la configuración de modelos de Cursor, pega tu clave de Fluxo como clave de API de OpenAI, activa la opción para cambiar la URL base e ingresa https://api.fluxorelay.com/v1. Luego agrega los ID de los modelos que quieras usar, como gpt-6.1-sol.

Los modelos de Claude no están disponibles mediante la URL personalizada de OpenAI en Cursor; usa Claude Code para acceder a ellos (consulta la nota en la sección de terminal).

Terminal

Los agentes de línea de comandos leen su configuración del entorno o de un archivo oculto. Abajo tienes un archivo por herramienta.

Claude Code y Claude Desktop

Configura dos variables de entorno y luego ejecuta claude. La URL base no lleva el sufijo /v1.

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

Versión para PowerShell:

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

Los modelos Claude solo están disponibles desde los clientes oficiales Claude Code y Claude Desktop, versión 2.1.285 o posterior. Esta restricción la aplica el proveedor de origen. GPT, Gemini y las demás familias funcionan desde cualquier cliente o SDK compatible con OpenAI.

CLI de Codex

Codex lee ~/.codex/config.toml. La línea env_key indica qué variable contiene tu clave de 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 y la API de Gemini

Configura GOOGLE_GEMINI_BASE_URL con el host de la API, sin agregar /v1beta, y coloca tu clave en GEMINI_API_KEY. Luego ejecuta 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"}]}]}'

En Fluxo, Gemini solo usa su protocolo nativo. Para streaming, usa :streamGenerateContent?alt=sse; /v1/chat/completions no acepta modelos Gemini.

Identificadores de modelos de Gemini:

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

cURL directo desde la terminal

Usa https://api.fluxorelay.com/v1 como base_url y tu clave de Fluxo como api_key. Las llamadas de chat van a /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"}]}'

IDs de modelos GPT recomendados para empezar:

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

Claves, errores y facturación

Las llamadas de tipo OpenAI envían la clave como token Bearer. Las de tipo Anthropic la envían en x-api-key. Las de Gemini usan x-goog-api-key.

Cada llamada se factura según el conteo de tokens que informa el proveedor. HTTP 402 indica que tu saldo está en cero o que agotaste el saldo del pase: recarga y vuelve a intentarlo.