Inicio rápido
La ruta más corta para que un nuevo usuario de MoleAPI pase del registro a completar su primera llamada
Bienvenido a MoleAPI.
Si tu objetivo ahora es solo uno: hacer funcionar la API lo antes posible, entonces esta documentación está hecha para ti. No necesitas leer toda la documentación de antemano; simplemente sigue estos 3 pasos y, por lo general, podrás completar tu primera integración funcional.
Paso 1: crea tu API Key
Antes de usar MoleAPI, primero debes crear una API Key (también llamada Token).
Su función es muy simple:
- Identificar tu identidad de llamada
- Controlar a qué modelos puedes acceder
- Registrar los logs y asignar los costes
Puedes crearla desde la consola:
- URL de acceso: https://home.moleapi.com/console/token
- Ruta en la página:
Consola → Gestión de KEY
La interfaz real de la página de creación es la siguiente:
Si solo vas a hacer una primera prueba, se recomienda completar los campos así:
- Nombre:
dev-local - Grupo: grupo predeterminado
- Fecha de expiración: un mes
- Cantidad: 1
- Restricción de modelos: sin restricciones por ahora
- Lista blanca de IP: dejar en blanco por ahora
Recomendación para el primer uso
Crea primero una Key dedicada a pruebas; no mezcles desde el principio el entorno de producción con el de pruebas.
Si quieres entender esta imagen campo por campo, puedes seguir leyendo:
Paso 2: prepara dos parámetros clave de integración
La mayoría de clientes, SDK o proyectos propios compatibles con la interfaz de OpenAI solo necesitan estos dos parámetros clave para empezar a usarse:
Los dos parámetros más importantes
- Base URL:
https://api.moleapi.com/v1 - API Key: la
sk-...que acabas de crear en la consola
Puedes entenderlo así:
- Base URL determina adónde se envía la solicitud
- API Key determina quién eres, si tienes permisos y a qué cuenta se asigna el coste de esta llamada
Por qué normalmente la Base URL debe completarse hasta /v1
Porque muchas herramientas siguen concatenando automáticamente rutas de la API después de la dirección que introduces, por ejemplo:
/chat/completions/responses/embeddings
Así que, si no estás seguro de cómo completarla, usa preferentemente:
https://api.moleapi.com/v1Si quieres comprender este punto con más detalle, puedes consultar:
Paso 3: pégalo en tu aplicación de AI o en tu código
Cuando ya tengas:
Base URLAPI Key
A continuación, puedes pegarlos en cualquier herramienta compatible con la interfaz de OpenAI, por ejemplo:
- Chatbox
- NextChat
- Cherry Studio
- Traducción inmersiva
- Código propio escrito con el OpenAI SDK
Normalmente, si estos dos valores están bien configurados, ya podrás empezar a hacer llamadas correctamente.
En las aplicaciones de AI, normalmente también necesitarás seleccionar un modelo para poder usarlo. Ten en cuenta lo siguiente:
- El modelo solo puede elegirse de la lista disponible en la página de precios de MoleAPI.
- Si tu Token tiene configurado un grupo, solo podrás elegir modelos disponibles dentro de ese grupo.
- Para consultar los modelos disponibles y la descripción de precios, consulta: Modelos compatibles y precios.
Si todavía no estás seguro de si tu cuenta, grupo y configuración de modelos son correctos, se recomienda primero hacer una ronda de pruebas dentro del sitio antes de conectar un cliente de terceros o código:
Si todavía no funciona, revisa primero estas 4 cosas
- Comprueba que la Base URL sea
https://api.moleapi.com/v1 - Comprueba que la API Key sea realmente una
sk-...creada en la consola de MoleAPI - Comprueba que el nombre del modelo esté escrito correctamente
- Comprueba que el grupo al que pertenece la Key actual sea compatible con ese modelo
La mayoría de los primeros problemas de los usuarios nuevos suelen quedarse atascados aquí.
A continuación, tienes dos rutas para seguir con la integración
No necesitas leer toda la documentación de una sola vez; basta con seguir según tu objetivo:
- Si quieres integrar una aplicación de AI ya existente: consulta primero la documentación de aplicaciones de AI y completa
Base URLyAPI Keyen la página de configuración del cliente correspondiente - Si quieres escribir tu propia integración en código: consulta primero Inicio rápido para desarrolladores y haz funcionar la llamada con la solicitud mínima
¿Qué se recomienda leer a continuación?
Si ya has completado tu primera llamada, lo siguiente recomendado depende de tu objetivo:
Conceptos básicos
Comprende los conceptos clave que más se confunden, como API Key, Base URL, grupos y facturación.
Tutoriales básicos dentro del sitio
Sigue aprendiendo sobre las funciones de la consola, como wallet, logs, selección de modelos y notificaciones.
Integración con aplicaciones de AI
Consulta cómo completar la configuración de MoleAPI en distintas herramientas cliente.
Documentación de la API para desarrolladores
Si vas a escribir tu propia integración en código, empieza aquí para consultar la API y los ejemplos.
¿Te resultó útil esta guía?
Última actualización el