TypingMind

Agrega OneProvider a TypingMind como custom model. TypingMind necesita la dirección completa del endpoint, no una base URL.

TypingMind no tiene un campo de base URL: el formulario de custom model recibe la dirección completa del endpoint y envía las solicitudes exactamente ahí, sin añadir nada. El campo integrado para la clave de API de Claude (Anthropic) se comunica directamente con Anthropic, así que una clave de OneProvider solo funciona en TypingMind como custom model.

1. Agrega un custom model

1. En TypingMind abre Models en la barra lateral izquierda, haz clic en Add custom model y quédate en Create Manually.
2. Name: cualquier nombre, por ejemplo OneProvider claude-opus-5-5.
3. Model ID: el id exacto de la página de modelos , por ejemplo claude-opus-5-5. El nombre visible «Claude Opus 5.5» no es un id.
4. Context Length: la ventana de contexto del modelo, en la misma página.

2. API Type, Endpoint URL y clave

En la pestaña Authentication elige uno de los dos tipos de API y completa los campos exactamente como se muestra abajo. La misma clave de OneProvider sirve para ambos.

Claude Messages API (modelos Claude)

API Type: Claude Messages API
Endpoint URL: https://api.oneprovider.dev/v1/messages
Authentication Type: API Key via HTTP Header
Header Key: x-api-key
Header Value: sk-your-key-here
Model ID: claude-opus-5-5

OpenAI Chat Completions API (modelos GPT y Claude)

API Type: OpenAI Chat Completions API
Endpoint URL: https://api.oneprovider.dev/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key: Authorization
Header Value: Bearer sk-your-key-here
Model ID: gpt-6.1-terra

Header Value es la palabra Bearer, un espacio y luego tu clave completa. Los id de Claude como claude-sonnet-5-5 también funcionan en esta ruta.

3. Temperature y opciones de la solicitud

• Deja temperature en el valor predeterminado. Los modelos Claude 5.x responden 400 a una temperature distinta de la predeterminada; si la cambiaste en la configuración del modelo o del chat de TypingMind, restablécela.
• Route requests via TypingMind Cloud no es necesario: nuestra API acepta solicitudes directamente desde el navegador (CORS).

4. Test & Save

Haz clic en Test & Save y luego elige el nuevo modelo en un chat.

Cada modelo es un custom model aparte: repite los pasos para cada id que quieras, con la misma Endpoint URL y la misma clave.

Qué modelo elegir

claude-opus-5-5 sirve para chats largos y exigentes, claude-sonnet-5-5 es la opción equilibrada por defecto y claude-haiku-5-5 es la opción rápida y económica; los modelos GPT como gpt-6.1-terra van por el tipo OpenAI Chat Completions API. Escribe el id exactamente como en la página de modelos ; las tarifas están en la página de precios .

Errores frecuentes y soluciones

404 Not Found

La Endpoint URL es una base URL (https://api.oneprovider.dev/v1 o https://api.oneprovider.dev). Usa https://api.oneprovider.dev/v1/messages para el tipo Claude Messages API o https://api.oneprovider.dev/v1/chat/completions para el tipo OpenAI Chat Completions API.

No se encuentra el modelo o no está disponible

El Model ID debe ser el id exacto, por ejemplo claude-opus-5-5, no el nombre visible del modelo. Cópialo de la página de modelos .

400 por la temperature

Los modelos Claude 5.x solo aceptan la temperature predeterminada. Restablece temperature en TypingMind al valor predeterminado y vuelve a enviar el mensaje.

401 authentication_error

Claude Messages API: Header Key x-api-key y la clave completa como valor. OpenAI Chat Completions API: Header Key Authorization y Bearer sk-... como valor.

La clave no funciona en el campo de Claude integrado en TypingMind

Ese campo envía las solicitudes a Anthropic, que no reconoce las claves de OneProvider. Agrega OneProvider como custom model, como se explica arriba.

Preguntas frecuentes

¿TypingMind necesita una base URL o el endpoint completo?

El endpoint completo. TypingMind no añade ninguna ruta, por eso la dirección debe terminar en /v1/messages o /v1/chat/completions.

¿Necesito Route requests via TypingMind Cloud?

No. Nuestra API acepta solicitudes desde el navegador (CORS), así que TypingMind puede llamarla directamente.

¿Puedo usar modelos GPT?

Sí: elige el tipo OpenAI Chat Completions API y un id de GPT como gpt-6.1-terra.

¿Una sola entrada puede cubrir todos los modelos?

No. Cada modelo es un custom model aparte con la misma Endpoint URL y la misma clave.

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 .