Playground

Verifica primero dentro del sitio si el modelo y la Key funcionan correctamente antes de decidir el método de integración posterior

Si ya has creado una API Key, pero todavía no estás listo para escribir código, la forma más sencilla de verificarlo es usar primero el playground del sitio.

Su valor no está solo en “probar un par de mensajes”, sino en ayudarte a confirmar rápidamente:

Si la cuenta actual puede invocar modelos con normalidad
Si los modelos disponibles en el grupo actual funcionan correctamente
Cómo es aproximadamente la experiencia de respuesta de un modelo concreto
Si tu configuración básica puede completarse correctamente

Nota sobre el alcance de la funcionalidad

El playground actual solo admite la interfaz chat/completions. Si necesitas probar funciones avanzadas como Tool-Calling, Agent, etc., por ahora haz la verificación mediante código o con herramientas de terceros que admitan estas funciones.

Dónde está el playground

Accede desde la consola:

Playground
Acceso directo: https://home.moleapi.com/console/playground

La interfaz real de la página es aproximadamente la siguiente:

Interfaz del playground de MoleAPI; a la izquierda están la configuración del modelo y los parámetros, y a la derecha el área de conversación

Cómo entender esta página

La página puede dividirse, a grandes rasgos, en dos partes:

Izquierda: área de configuración del modelo

Aquí se usa principalmente para seleccionar y ajustar:

Grupo
Modelo
Si se habilita la entrada de imágenes
Parámetros como Temperature / Top P / Frequency Penalty
Si se usa salida en streaming

Para principiantes, lo más importante no es entender todos los parámetros desde el principio, sino completar primero estas dos cosas:

Elegir un modelo que esté disponible actualmente
Enviar el primer mensaje que pueda devolver una respuesta correctamente

Derecha: área de conversación

Esta es el área de conversación real. Puedes introducir preguntas directamente, observar los resultados devueltos y comprobar:

Si la respuesta es normal
Cómo es la velocidad de respuesta
Si el estilo de salida coincide con lo esperado

Cómo se recomienda usar el playground para principiantes

Se recomienda probar en este orden:

Selecciona primero un modelo de texto general
No cambies demasiados parámetros al principio
Envía primero una frase muy simple, por ejemplo, “Hola”
Cuando responda de forma estable, prueba gradualmente preguntas más complejas

Las ventajas de hacerlo así son:

Puedes distinguir primero entre “la plataforma funciona” y “tu código posterior tiene problemas”
Puedes determinar rápidamente si el modelo/grupo está disponible
Te permite validar la experiencia antes de integrarlo realmente en un cliente externo

Si el playground funciona correctamente, ¿qué significa?

Si aquí ya puedes conversar de forma estable, normalmente significa que:

Tu cuenta y los permisos básicos están bien
La plataforma puede invocar correctamente ese modelo en este momento
Si luego falla en una aplicación de terceros o en tu código, es más probable que sea un problema de configuración de la integración

Por eso recomiendo a muchos principiantes:

Primero comprueba que todo funciona dentro del sitio y luego integra aplicaciones de terceros o el SDK.

Problemas frecuentes

El playground funciona, pero el cliente de terceros no

Comprueba primero:

Si el Base URL del cliente de terceros es correcto
Si la API Key se ha copiado completa
Si el nombre del modelo coincide
Si la herramienta de terceros admite interfaces compatibles con OpenAI

En el playground no se puede seleccionar el modelo o el resultado no es el esperado

Comprueba primero:

Si el grupo actual admite ese modelo
Si el modelo que has elegido es adecuado para la tarea actual
Si has cambiado demasiados parámetros por error

¿Qué hacer si la respuesta es muy lenta?

No concluyas de inmediato que hay un problema en la plataforma; primero puedes intentar:

Cambiar de modelo
Cambiar de grupo
Probar con una pregunta más corta
Evitar usar un contexto demasiado largo desde el principio

Consejo de uso más práctico

El playground es más útil como “punto de comprobación previo a la integración” y “espacio de prueba de modelos” que como una simple página de demostración.