Autenticación

OneProvider acepta tanto Bearer al estilo OpenAI como x-api-key al estilo Anthropic. Usa uno de los dos, nunca ambos.

Formas del encabezado

La API acepta cualquiera de los dos encabezados. Usa el que ya envía tu SDK.

Authorization: Bearer sk-... # OpenAI-style
x-api-key: sk-... # Anthropic-style

Variables de entorno

En nuestros ejemplos la clave está en ONEPROVIDER_KEY. Sin embargo, los clientes SDK leen por defecto sus propios nombres nativos: exporta la clave con ese nombre o pasa ONEPROVIDER_KEY de forma explícita al constructor. La tabla de abajo muestra qué lee cada herramienta:

Verificar la autenticación

Llama a /v1/models para una comprobación barata y sin efectos secundarios:

curl -s https://api.oneprovider.dev/v1/models \
-H "x-api-key: $ONEPROVIDER_KEY" | jq '.data[].id'

Una respuesta correcta lista los modelos actuales. Un 401 aquí significa que la clave está mal formada, fue revocada o aún no está activa.

Dónde guardar la clave

• Variables de entorno: la opción por defecto para la mayoría de los casos.
• ~/.zshrc / ~/.bashrc con HISTCONTROL=ignorespace, para que los comandos que empiezan con un espacio no entren en el historial del shell.
• Gestores de secretos: 1Password CLI, AWS Secrets Manager, Doppler, GCP Secret Manager.
• Archivos .env por proyecto: siempre incluidos en .gitignore.

Errores frecuentes

• Barra final. https://api.oneprovider.dev/v1/ frente a https://api.oneprovider.dev/v1: algunos SDK concatenan la ruta sin cuidado. Usa la forma sin barra final de arriba.
• Doble Bearer. Authorization: Bearer Bearer sk-... ocurre cuando una herramienta ya antepone Bearer y tú lo vuelves a añadir. Quita el prefijo en tu configuración.
• Encabezado de versión de Anthropic. Incluye siempre anthropic-version: 2023-06-01 en las llamadas HTTP directas. Los SDK lo añaden por ti.

Rotación de claves

Emite una clave nueva en el panel (“Claves” → “Emitir una clave”), actualízala en tus clientes y después elimina la anterior. Es instantáneo y gratis, y el saldo es compartido por todas las claves del panel. Más: Panel y claves .

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 .