Cómo rellenar la Base URL

Rellenar correctamente la Base URL es el primer paso para completar la integración con MoleAPI

La Base URL es la dirección base que usa el cliente o el SDK para solicitar la API.

Puedes entenderla como “a dónde debe enviarse la solicitud”. Si esta dirección está mal, aunque tu API Key sea correcta, la solicitud seguirá fallando.

Ejemplo de configuración de la dirección de la API: la Base URL en el campo de entrada y la dirección completa de la solicitud en la vista previa inferior

La forma de configuración más habitual en MoleAPI

Para la gran mayoría de herramientas y SDK compatibles con interfaces OpenAI, se recomienda rellenar directamente:

https://api.moleapi.com/v1

Esta es la configuración que los principiantes deberían recordar primero.

Por qué en muchos casos hay que incluir `/v1`

Porque muchos SDK o clientes añaden automáticamente a la Base URL que indiques una ruta como las siguientes:

/chat/completions
/responses
/embeddings
/images/generations

Así que si rellenas:

https://api.moleapi.com/v1

La dirección completa que finalmente se compone puede ser:

https://api.moleapi.com/v1/chat/completions

Normalmente, esto es lo correcto.

Cuándo se puede omitir `/v1`

Algunas pocas herramientas requieren que indiques la “dirección raíz del sitio” y luego añaden internamente /v1 por su cuenta.

En ese caso, puedes probar con:

https://api.moleapi.com

Pero si no estás seguro, prueba primero con https://api.moleapi.com/v1.

Conclusión sencilla para principiantes

Si no tienes claro qué poner, usa primero: https://api.moleapi.com/v1

Los errores de configuración más comunes

Error 1: usar la dirección oficial de OpenAI

Por ejemplo:

https://api.openai.com/v1

Así, la solicitud no pasará por MoleAPI, sino que se enviará directamente a OpenAI.

Error 2: omitir `/v1`

Algunas aplicaciones exigen que se complete hasta /v1. Si solo escribes:

https://api.moleapi.com

Pueden aparecer errores como:

404
Invalid URL
la interfaz no existe
error al componer la ruta de la solicitud

Error 3: usar la ruta completa de la interfaz como Base URL

Por ejemplo, si la escribes así:

https://api.moleapi.com/v1/chat/completions

Normalmente esto no es correcto, porque muchos SDK seguirán añadiendo rutas al final, y la URL acabará mal compuesta.

A menos que una herramienta indique explícitamente que debes introducir la dirección completa de la interfaz, la Base URL normalmente solo debe llegar hasta:

https://api.moleapi.com/v1

Error 4: copiar espacios de más, símbolos en chino o un protocolo incorrecto

Por ejemplo:

https//api.moleapi.com/v1
http://api.moleapi.com/v1
espacios adicionales al principio o al final de la dirección
caracteres de ancho completo copiados por error

Este tipo de problema es muy común y, a simple vista, no siempre se detecta de inmediato.

Cómo comprobar rápidamente si lo has rellenado bien

Puedes revisarlo en este orden:

Si la Base URL es https://api.moleapi.com/v1
Si la API Key es la sk-... que creaste en la consola de MoleAPI
Si el nombre del modelo es uno disponible en el Group actual
Si el cliente es compatible con interfaces OpenAI

Si ya has confirmado que todo esto es correcto y sigue fallando, entonces revisa logs más detallados y los códigos de error.

Recomendaciones para escenarios habituales

Escenario 1: integración con clientes de terceros

Como herramientas del tipo Chatbox, NextChat, 沉浸式翻译, Cherry Studio:

Usa prioritariamente https://api.moleapi.com/v1
En API Key, introduce tu sk-...

Escenario 2: integración con OpenAI SDK

Tanto si usas Node.js, Python como cualquier otro SDK compatible con OpenAI, normalmente también conviene usar primero:

https://api.moleapi.com/v1

Escenario 3: en el mensaje de error aparece `api.openai.com`

Normalmente esto indica que tu solicitud ni siquiera está pasando por MoleAPI, sino que sigue yendo a la dirección oficial de OpenAI. Revisa primero si la Base URL se ha cambiado correctamente.