Documentación de la API de Claude y GPT: claves, SDK, clientes

Una clave y dos base URL compatibles para modelos de producción, clientes y API de medios.

Para un agente de IA

¿Te atascaste? Pásaselo a un agente de IA

Envía el enlace de abajo a cualquier agente de IA (Claude Code, Codex, Cursor…) y pídele que configure tu cliente: tiene todo lo que necesita un agente, desde los ajustes de cada cliente hasta la verificación.

Tres pasos

1. Obtén una clave en el panel

   Abre el panel, recarga el saldo (o canjea un código de marketplace) y pulsa “Emitir una clave”.

   app.oneprovider.dev Cómo funciona

2. Elige tu cliente

   Cada cliente tiene su propia guía breve.

   • Claude Code
   • Claude Desktop
   • Codex (OpenAI)
   • Cursor
   • Hermes Agent
   • Cline
   • OpenClaw
   • VS Code
   • OpenCode
   • Open Cowork
   • Factory Droid
   • n8n
   • Python SDK
   • Node SDK

3. Configura la base URL y la clave

   La clave va en el encabezado x-api-key o Authorization: Bearer. La dirección depende del tipo de cliente:

   Anthropic (Claude Code, SDK de Anthropic), sin /v1 https://api.oneprovider.dev OpenAI (Codex, Cursor, SDK de OpenAI), con /v1 https://api.oneprovider.dev/v1 bash

   curl -s https://api.oneprovider.dev/v1/models \
   -H "Authorization: Bearer sk-your-key-here"

   Si la respuesta trae una lista de modelos, la clave funciona.

Siguiente

• Modelos y precios
• Autenticación
• Messages API
• Chat Completions
• Panel y claves
• Errores y diagnóstico

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .