Endpoints personalizados y Base URL

Endpoint de API personalizado: cómo conectar una API compatible con OpenAI

Qué es un endpoint de API personalizado o Base URL, y cómo conectar una API compatible con OpenAI, un relay, un proxy o un gateway con dirección y clave.

Actualizado
  • Un endpoint de API personalizado es la dirección web, o Base URL (URL base), de un servicio de IA que no viene integrado en tu app: una API compatible con OpenAI, un relay (servicio de retransmisión), un proxy o un gateway (pasarela). En Oriveo, para conectarlo suelen bastar dos cosas: esa dirección y una clave de API (API key).
  • Oriveo identifica el protocolo por ti (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages o Gemini) y agrega la ruta de versión, como /v1, cuando escribes solo la dirección raíz.
  • Las direcciones públicas deben usar HTTPS. Un servicio de terceros puede ver todo lo que envías a través de él, así que dale una clave aparte con un límite de gasto y nunca le entregues la clave oficial de tu proveedor.
Oriveo en iPhone: la pantalla de proveedores, con los proveedores que has conectado y el gasto de este mes.

¿Qué es una Base URL o un endpoint de API?

Todo servicio de IA tiene una dirección web a la que las apps envían las solicitudes. Los desarrolladores la llaman Base URL, endpoint de API o URL de solicitud; aquí significan lo mismo. Parece una dirección web normal. La de OpenAI, por ejemplo, es https://api.openai.com/v1.

En Oriveo, los 15 proveedores integrados ya tienen su dirección configurada, así que solo pegas una clave. Un endpoint personalizado sirve para todo lo demás: un servicio que ofrece una API compatible con OpenAI, un relay o gateway que administra una empresa, o un gateway que tú instalas en tu propio servidor.

«Compatible con OpenAI» significa que el servicio acepta solicitudes con el mismo formato que la API de OpenAI, de modo que las apps hechas para OpenAI pueden comunicarse con él. Muchos proveedores y gateways ofrecen este formato.

Relay, proxy, gateway: ¿cuál es la diferencia?

Estas palabras se usan sin mucho rigor, y para conectar una app funcionan igual: un servicio se coloca entre tu app y los proveedores de modelos, recibe tu solicitud y la reenvía. Algunos reúnen varios proveedores con una sola clave y una sola factura; otros agregan controles de uso para un equipo; otros son software que instalas en tu propio servidor.

Oriveo no recomienda ni clasifica ninguno. Uses el que uses, los pasos de abajo son los mismos.

¿Qué necesito para conectar un endpoint personalizado?

Normalmente dos cosas, que encuentras en el panel o en la documentación del propio servicio:

  • La URL de solicitud (Base URL), por ejemplo https://api.example.com/v1. Debe empezar por https:// si el servicio está en internet público.
  • Una clave de API que te haya dado ese servicio. Puedes agregar más claves con «Agregar otra clave».
  • Opcional: un nombre para la conexión, para distinguirla de las demás.

¿Cómo agregar un endpoint personalizado en Oriveo?

Los pasos son los mismos en iPhone, Android y la web.

  • Abre «Proveedores» y toca el botón + («Agregar proveedor»).
  • Elige el filtro «Personalizado» y luego «Retransmisión personalizada» («Conecta tu propio servicio de modelos»).
  • En «Conecta una retransmisión personalizada», pega la URL de solicitud y la clave de API. La línea «Se enviará a …» muestra la dirección completa que usará Oriveo. Toca «Siguiente».
  • Oriveo comprueba la conexión, lee la lista de modelos y determina el protocolo de cada uno. En este paso se lee la lista sin enviar ningún mensaje de chat.
  • Marca los modelos que quieras y toca «Guardar (seleccionados: N)». Si el servicio no publica su lista de modelos, usa «Agregar ID de modelo manualmente».
  • Antes de guardar, Oriveo envía una solicitud mínima al primer modelo seleccionado. La conexión se guarda cuando esa prueba sale bien; si falla, te quedas en el mismo paso y puedes corregirlo.
Pantalla «Proveedores» de Oriveo en iPhone con el botón + arriba a la derecha y la lista de proveedores conectados
Toca + en la pantalla «Proveedores» y elige «Personalizado» para agregar un endpoint junto a tus proveedores integrados.

¿Prefieres configurarlo todo tú? Usa la configuración manual

«Configuración manual» reúne todo en una sola página: la dirección, la clave, un ID de modelo, un nombre opcional para la conexión y el protocolo predeterminado, que empieza en automático. Toca «Validar y guardar». Si la comprobación falla, todavía no se guarda nada, y la tarjeta de error ofrece «Guardar de todos modos (sin verificar)» por si quieres conservar la conexión y probarla más tarde.

¿Oriveo detecta el protocolo automáticamente?

En la mayoría de los casos, sí. Los servicios de IA usan uno de unos pocos formatos de solicitud, llamados protocolos. Oriveo admite cuatro: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages y Gemini generateContent.

Decide modelo por modelo. Usa lo que el servicio informa sobre cada modelo cuando esa información existe y, si no, elige los candidatos más probables según la familia del modelo. Al guardar, el primer modelo seleccionado se prueba con una solicitud real; los demás se comprueban más tarde, cuando empiezas a usarlos.

Por eso, en la mayoría de los casos bastan la dirección y la clave. Si la documentación del servicio indica un protocolo concreto, o un modelo falla la comprobación, elige tú el protocolo en «Configuración manual».

¿Tengo que agregar /v1 a la dirección?

Normalmente no. Si escribes solo la dirección raíz, como https://api.example.com, Oriveo agrega la ruta de versión estándar del protocolo: /v1 para los formatos de OpenAI y Anthropic, /v1beta para Gemini.

Si la dirección ya incluye una versión, como /api/paas/v4, Oriveo la conserva. Si pegas un endpoint completo que termina en /chat/completions, /responses, /messages o :generateContent, Oriveo quita esa terminación y la usa para saber qué protocolo habla el servicio.

Revisa la línea «Se enviará a …» antes de tocar «Siguiente». Si la comprobación dice «Puede que la dirección apunte a una página web. Comprueba si falta /v1.», compara tu dirección con la documentación del servicio.

¿Tengo que agregar /v1 a la dirección?
EscribesOriveo envía a (formato OpenAI)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1, con Chat Completions
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

¿Qué direcciones se admiten?

Oriveo sigue algunas reglas para proteger tu clave:

  • Las direcciones públicas deben empezar por https://. Una dirección http:// en internet público no se puede probar ni guardar.
  • No se aceptan direcciones que incluyan un usuario y una contraseña, ni direcciones con parámetros de consulta (cualquier cosa después de un «?»). Oriveo nunca intenta tomar claves de API de los parámetros de consulta.
  • Las direcciones http:// de tu red doméstica o de una VPN privada, como un servidor de modelos en tu propia computadora, se agregan desde la entrada aparte «Cómputo local» («Cómputo local y LAN» en iPhone), no desde «Retransmisión personalizada».
  • En iPhone y Android, la app se conecta directamente a la dirección.
  • En la app web, las URL de solicitud públicas se reenvían a través del servidor de Oriveo para sortear las limitaciones de CORS del navegador (una regla de seguridad del navegador que bloquea muchas solicitudes directas): tu clave de API solo permanece en memoria durante esa solicitud y nunca se almacena ni se registra. Las direcciones de la red local se conectan directamente desde tu dispositivo, y en ambos casos se requiere HTTPS; para una dirección http:// de tu red doméstica necesitas la app de iPhone o Android y su entrada «Cómputo local» («Cómputo local y LAN» en iPhone).
  • Las claves se quedan en este dispositivo y no se suben con la sincronización en la nube.

Base URL de los proveedores integrados

En Oriveo no las necesitas: basta con elegir el proveedor por su nombre. Las incluimos porque mucha gente las busca para otras herramientas. Cada una es la dirección oficial compatible con OpenAI que indica la documentación del proveedor, a 18 de noviembre de 2026.

  • Anthropic describe su capa compatible con OpenAI como pensada para pruebas y comparaciones, y la guía de inicio rápido de Mistral no describe su API como compatible con OpenAI. Agrega ambos como proveedores integrados.
Base URL de los proveedores integrados
ProveedorBase URL compatible con OpenAI
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI (Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://api.fireworks.ai/inference/v1
MiniMax (internacional)https://api.minimax.io/v1
Z.ai (internacional)https://api.z.ai/api/paas/v4/
Qwen (región de Singapur)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (internacional)https://api.moonshot.ai/v1
SiliconFlow (internacional)https://api.siliconflow.com/v1

¿Es seguro usar un relay o una API de terceros?

Ten cuidado. Cualquier servicio que esté entre tú y el modelo puede leer tus prompts, los archivos que adjuntas y las respuestas, y fija sus propios precios. Oriveo no puede ver lo que pasa dentro de ese servicio ni responder por él.

  • Nunca le des a un servicio de terceros la clave de API de tu cuenta oficial del proveedor. Usa la clave que te da ese servicio.
  • Crea una clave aparte para Oriveo y, si el servicio lo permite, ponle un límite de gasto o mantén poco saldo en ella.
  • No envíes contraseñas, números de identificación ni trabajo confidencial a través de un servicio en el que no confíes.
  • Revisa tu consumo en el panel del propio servicio. Las cifras de costo de Oriveo son estimaciones; los registros del servicio son los definitivos.
  • Si una clave se filtra, bórrala en el panel del servicio y crea otra.

¿Por qué no se conecta mi endpoint personalizado?

Oriveo te dice en una línea qué salió mal. Estos son los mensajes, tal como aparecen en español:

  • Para códigos como 401, 402 y 429, nuestra guía de errores de API key explica qué significa cada uno.
¿Por qué no se conecta mi endpoint personalizado?
Mensaje en OriveoQué revisar
Puede que la dirección apunte a una página web. Comprueba si falta /v1.Compara la dirección con la documentación del servicio; agrega o quita la ruta de versión
La clave no es válida.Vuelve a copiar la clave desde el panel del servicio
Esta clave no tiene permiso para ver la lista de modelos. Puedes agregar modelos manualmente.Agrega tú el ID del modelo en el paso siguiente
No se puede conectar. Revisa tu red o proxy.Revisa tu conexión a internet y que la dirección sea accesible
El servicio de esta dirección está limitando las solicitudes.Espera un momento y vuelve a intentarlo
Esta conexión no pudo comunicarse con su proveedor de origen.La cuenta del propio servicio con el proveedor puede no ser válida, haberse quedado sin créditos o tener un límite de solicitudes; contacta a quien lo administra

Preguntas frecuentes sobre la app

¿Qué es un endpoint de API personalizado?
Es la dirección web de un servicio de IA que no viene integrado en tu app, como una API compatible con OpenAI, un relay o un gateway. Lo conectas escribiendo esa dirección (la Base URL) y una clave de API del servicio.
¿Qué es una API compatible con OpenAI?
Una API que acepta solicitudes con el mismo formato que la de OpenAI, de modo que las apps hechas para OpenAI pueden usarla. Muchos proveedores y gateways ofrecen una, normalmente en una dirección que termina en /v1.
¿Qué Base URL tengo que escribir?
La que indica la documentación del servicio. Si solo da un dominio, escríbelo y Oriveo agrega /v1 (o /v1beta para el formato de Gemini). Revisa la línea «Se enviará a …» antes de continuar.
¿Puedo usar un endpoint personalizado en iPhone y Android?
Sí. «Retransmisión personalizada» está en las apps de Oriveo para iPhone y Android y en la app web. En iPhone y Android, la app se conecta directamente a la dirección.
¿Por qué Oriveo exige HTTPS?
HTTPS cifra la conexión, así que tu clave y tus mensajes no viajan por internet como texto legible. Para un servidor de modelos en tu red doméstica, usa la entrada «Cómputo local» («Cómputo local y LAN» en iPhone).
¿Es seguro usar un relay o un proxy de API?
El servicio puede leer todo lo que envías a través de él, así que la confianza es fundamental. Usa una clave que te dé el servicio, nunca la clave oficial de tu proveedor; ponle un límite de gasto y no envíes información sensible por ahí.

Lecturas relacionadas

Del blog

Conecta tu propio servicio de modelos

Abre la app web o descarga Oriveo para iPhone o Android, elige «Retransmisión personalizada» y pega la dirección y la clave de tu servicio.

¿Todavía no tienes una clave de API? Con Oriveo Free puedes empezar sin ella.