free-ide-proxy/CREDENCIALES.md

Free IDE Proxy — Credenciales y Modelos

Endpoint

http://127.0.0.1:6446

Clientes compatibles

Cualquier cliente OpenAI o Anthropic. Apunta la base URL a http://127.0.0.1:6446.

Claude Code

export ANTHROPIC_BASE_URL="http://127.0.0.1:6446"
export ANTHROPIC_MODEL="claude-sonnet-4-6"   # se mapea a deepseek-v4-flash-free

Claude Code agrega /v1/messages automáticamente. No pongas /v1 en la base URL.

OpenAI SDK

from openai import OpenAI
client = OpenAI(base_url="http://127.0.0.1:6446/v1", api_key="...")

response = client.chat.completions.create(
    model="deepseek-v4-flash-free",
    messages=[{"role": "user", "content": "Hello"}]
)

curl

curl http://127.0.0.1:6446/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-free",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": true
  }'

curl http://127.0.0.1:6446/v1/messages \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash-free",
    "max_tokens": 1000,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Autenticación

Actualmente: DESHABILITADA (sin API key).

Para activar:

# Por flag
./free-ide-proxy -api-key "tu-clave-secreta"

# O por env var
export OPENCODE_PROXY_KEY="tu-clave-secreta"

Headers aceptados: Authorization: Bearer <key> o x-api-key: <key>

---

Modelos disponibles

Auto-discovery activo. El proxy descubre modelos automáticamente cada 10 min desde los /models de cada upstream. La lista de abajo es la base curada (metadata confiable + aliases); los modelos adicionales descubiertos aparecen en /v1/models en runtime. Consultá siempre el endpoint para la lista vigente:

curl -s http://127.0.0.1:6446/v1/models | python3 -m json.tool

Estrategia por backend:

• Kilo → full auto: parsea isFree:true + metadata completa (ctx, max_tokens, vision). Modelos nuevos aparecen solos.
• OpenCode → heurística: curados + cualquier ID con token free (sufijo -free/:free).
• Kimchi → todos los IDs del upstream (cuenta por crédito, todos usables).

OpenCode Zen (opencode.ai/zen/v1)

Modelo ID	Aliases	Contexto	Output	Tags
deepseek-v4-flash-free	deepseek, deepseek-v4, ds	1M	384K	⭐ recomendado, razonamiento, propósito general
big-pickle	pickle	200K	32K	legacy, refactors, mantenimiento
mimo-v2.5-free	mimo, mimo-v2.5, xiaomi	1M	32K	multimodal, imágenes → código, MIT
north-mini-code-free	north, north-mini, cohere	256K	64K	respuesta rápida, scripts
nemotron-3-ultra-free	nemotron, nemotron-3, nvidia	1M	16K	razonamiento, Mamba-2 + MoE

Kilo Gateway (api.kilo.ai/api/gateway)

Modelo ID	Aliases	Contexto	Output	Tags
stepfun/step-3.7-flash:free	stepfun, stepfun-free	256K	32K	flash, tareas generales
poolside/laguna-m.1:free	poolside, poolside-free, laguna	256K	32K	código
nvidia/nemotron-3-ultra-550b-a55b:free	—	1M	16K	razonamiento, MoE
openrouter/free	openrouter	256K	32K	selección automática

Kilo además auto-descubre modelos free adicionales (ej: kilo-auto/free, tencent/hy3:free, cohere/north-mini-code:free, nvidia/nemotron-3-super-120b-a12b:free, etc.) con metadata completa del upstream.

Kimchi Dev (llm.kimchi.dev/openai/v1)

Modelo ID	Aliases	Contexto	Output	Tags
deepseek-v4-flash	kimchi, kimchi/deepseek	1M	1M	⭐ rápido, razonamiento
glm-5.2-fp8	kimchi/glm	1M	1M	GLM, FP8
kimi-k2.7	kimchi/kimi	262K	262K	Moonshot, visión
minimax-m3	kimchi/minimax	1M	1M	MiniMax, visión
nemotron-3-ultra-fp4	kimchi/nemotron	1M	1M	NVIDIA, FP4

Kimchi auto-descubre todos los IDs del upstream (cuenta por crédito). Adicionales típicos: qwen3-coder-next-fp8, nemotron-3-super-fp4, kimi-k2.5/k2.6, minimax-m2.5/m2.7, smollm2-*. Requiere header User-Agent: kimchi/0.1.50 (sino el upstream devuelve 402).

Alias de modelos Claude

Alias Claude	Se resuelve a
claude-sonnet-4-6	deepseek-v4-flash-free
claude-sonnet-4	deepseek-v4-flash-free
claude-3.5-sonnet	deepseek-v4-flash-free
claude-3-haiku	deepseek-v4-flash-free
claude-opus	deepseek-v4-flash-free

Notas

• Auto-discovery: cada 10 min el proxy refresca el catálogo desde los /models de cada upstream. Los modelos descubiertos se agregan a /v1/models en runtime; la base curada (metadata + aliases) siempre se preserva.
• Razonamiento: DeepSeek, Nemotron y StepFun necesitan max_tokens >= 500. Con valores chicos devuelven contenido vacío.
• Rate limiting: si un modelo devuelve 429, se oculta de /v1/models y se reintenta cada 30 min.
• Modelos nuevos: los descubiertos rutean a su backend correcto automáticamente. Los totalmente desconocidos se reenvían al backend default (OpenCode Zen) como pass-through.
• Session rotation: las sesiones rotan cada 30 min.
• Claude Code: el proxy también acepta /v1/v1/messages por el bug de doble path.