Qué es un grupo

Comprende la relación entre los grupos de MoleAPI y la disponibilidad de modelos, las estrategias de precios y la estabilidad

En MoleAPI, un grupo puede entenderse como “qué conjunto de canales de modelo y estrategia de precios utiliza un determinado API Key”.

No es un campo meramente informativo, sino que afecta directamente a:

Qué modelos puede ver este Key
Qué tipo de canales se utilizan al invocar esos modelos
La estrategia de precios correspondiente
En algunos casos, la estabilidad y los escenarios de uso aplicables

Por qué existen los grupos

Si la plataforma mezclara todos los modelos, todos los precios y todos los canales, a los usuarios les resultaría difícil diferenciarlos según el uso.

La existencia de los grupos permite gestionar por separado distintos objetivos, por ejemplo:

Que los entornos de prueba y producción utilicen grupos diferentes
Que el tráfico sensible al coste use un grupo más económico
Que el tráfico que prioriza la estabilidad use un grupo más estable
Que determinados modelos solo puedan ser utilizados por ciertos Key

Cómo puedes entender un grupo

Una forma más práctica de entenderlo es:

Grupo = combinación de conjunto de modelos + estrategia de canales + estrategia de precios

Por eso, incluso para un mismo modelo, en distintos grupos pueden darse situaciones como:

Diferente disponibilidad; cambiar de grupo puede hacer que un modelo deje de estar disponible
Diferente precio unitario; algunos pueden tener descuento
Diferente experiencia de estabilidad; por ejemplo, la estabilidad del grupo relay puede ser inferior

En el filtro de la izquierda de la página de precios de la consola, selecciona «grupos de Token disponibles» para ver la lista de modelos visibles dentro de ese grupo.

Página de precios de la consola de MoleAPI: a la izquierda, filtro de grupos de Token disponibles (como default, discount); al seleccionar un grupo, a la derecha se muestra la lista de modelos que pueden usarse dentro de ese grupo

Tipos de grupos habituales

A continuación se muestran varias categorías comunes en la documentación y fáciles de entender:

Tipo de grupo	Características	Escenarios adecuados
`default`	Grupo predeterminado; normalmente más estable y más general	Proyectos en producción, uso a largo plazo
`discount`	Grupo de promoción o descuento	Sensibilidad al coste, disposición a seguir los cambios de promociones
`relay`	El precio suele ser más bajo, pero la experiencia puede depender más del canal concreto	Pruebas, experimentación y escenarios más sensibles al coste

En la práctica, prevalece la información actual de grupos mostrada en la consola y en los anuncios del sistema.

Qué deberían elegir los principiantes

Si es tu primera integración, se recomienda:

Usar primero el grupo predeterminado para completar el flujo
Una vez funcione, ajustar según precio, cobertura de modelos y estabilidad

Esto se debe a que, para principiantes, es más importante lograr que funcione primero que ahorrar al máximo desde el inicio.

Cuándo conviene diferenciar claramente los grupos

En los siguientes escenarios, se recomienda planificar los grupos de forma explícita:

1. Separar producción y pruebas

No mezcles el tráfico de pruebas y el negocio en producción bajo la misma estrategia.

2. Quieres controlar los costes

Si eres muy sensible al precio, el grupo será una herramienta de ajuste muy importante.

3. Distintos sistemas tienen permisos diferentes

Por ejemplo:

Los proyectos internos de experimentación pueden usar grupos más económicos
Los productos en producción solo exponen unos pocos modelos estables

4. Quieres observar el efecto de distintos canales

A veces, la experiencia del mismo modelo puede variar entre grupos diferentes. Lo adecuado es probar primero con poco tráfico y luego decidir la estrategia a largo plazo.

Relación entre grupo y API Key

Normalmente, el grupo se configura en el API Key. Al crear o editar un API Key, selecciona el grupo al que pertenece ese Key en «grupo de Token» (por ejemplo, default, discount, relay); los distintos grupos corresponden a diferentes Ratio y rangos de modelos.

Interfaz de selección del grupo de Token al crear o editar un API Key: bajo el campo de entrada se muestran grupos como default (estándar 1x), discount (oferta 0.8x), relay (reenvío 0.3x) y sus Ratio correspondientes

Esto significa que:

Distintos Key pueden usar grupos diferentes
Una misma cuenta puede tener simultáneamente varias estrategias
Puedes asignar distintos Key por proyecto o entorno y configurarles grupos diferentes

Por eso solemos recomendar:

Un Key de pruebas
Un Key de producción
Si es necesario, un Key independiente para cada sistema

Recomendaciones de uso

Prácticas recomendadas

Los principiantes deberían empezar con default
Separar varios Key por entorno
Para negocios importantes, priorizar primero la estabilidad y después considerar grupos más económicos
Antes de poner en producción, realizar pruebas reales en el grupo objetivo

Prácticas no recomendadas

Que todos los proyectos compartan un solo Key y un solo grupo
Cambiar directamente el tráfico de producción a un grupo desconocido sin entender cómo funciona
Fijarse solo en el precio e ignorar la disponibilidad de modelos y la estabilidad

Consejo en una frase

Primero usa el grupo predeterminado para completar el flujo y después optimiza los grupos según coste, modelos y requisitos de estabilidad.