Bola 8 (IA)

Responde preguntas del chat con inteligencia artificial. A diferencia de respuestas fijas, el modelo interpreta el contexto de cada pregunta y adapta el tono según la personalidad elegida.

GEThttps://ttv.losperris.dev/api/minigames/magic8

AutenticaciónTodos los endpoints requieren el parámetro apiKey en la query. Obtén la tuya desde el panel.›

Parámetros

Parámetro	Tipo	Requerido	Descripción
question	String	Sí	Pregunta del viewer (3–500 caracteres).
apiKey	String	Sí	Clave de API de tu cuenta.
user	String	No	Usuario que pregunta; la IA se dirige a @user en la respuesta.
mood	String	No	Personalidad de la respuesta. Por defecto classic. Ver opciones abajo.

Personalidades (mood)

El parámetro opcional mood define cómo habla la bola. Por defecto: classic. Si envías un valor no reconocido, se usa classic (mismas opciones que el selector Personalidad del panel).

Valor	Nombre	Comportamiento
classic	Clásica	Oráculo ancestral: tono solemne y teatral. Veredictos claros (sí, no o señales concretas) sin evasivas.
sarcastic	Sarcástica	Cinismo y humor mordaz. Responde al tema pero ridiculiza la pregunta o las expectativas del viewer.
toxic	Tóxica	Manipulación emocional y tono posesivo. Gira la respuesta hacia celos o control. Usar con moderación en stream.
helpful	Servicial	Coach hiperpositivo: hype, ánimo extremo y emojis moderados (✨🚀💖). Reframe optimista incluso en respuestas negativas.

Modo tóxico

toxic puede sonar agresivo o incómodo en chat público. Prueba la personalidad en el panel antes de activarla en el bot.

Añade &mood= a la URL del comando:

https://ttv.losperris.dev/api/minigames/magic8?question=$(querystring)&mood=sarcastic&user=$(user)&apiKey=TU_API_KEY

Ejemplo de petición

cURLcURL -iURL

curl --request GET \
  --url 'https://ttv.losperris.dev/api/minigames/magic8?question=%C2%BFLlegar%C3%A9+a+partner+este+a%C3%B1o%3F&apiKey=TU_API_KEY&user=viewer123&mood=classic' \
  --header 'Accept: text/plain'

curl -i --request GET \
  --url 'https://ttv.losperris.dev/api/minigames/magic8?question=%C2%BFLlegar%C3%A9+a+partner+este+a%C3%B1o%3F&apiKey=TU_API_KEY&user=viewer123&mood=classic' \
  --header 'Accept: text/plain'

https://ttv.losperris.dev/api/minigames/magic8?question=%C2%BFLlegar%C3%A9+a+partner+este+a%C3%B1o%3F&apiKey=TU_API_KEY&user=viewer123&mood=classic

Respuestas

200503

Las señales apuntan a que sí.

HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Cache-Control: public, s-maxage=10, stale-while-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

Las señales apuntan a que sí.

El servicio de IA no está configurado en el servidor.

HTTP/1.1 503 Service Unavailable
Content-Type: text/plain; charset=utf-8
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 29
X-RateLimit-Reset: 1710000060

El servicio de IA no está configurado en el servidor.

Integración con bots

Nightbot

!addcom !bola8 $(urlfetch https://ttv.losperris.dev/api/minigames/magic8?question=$(querystring)&user=$(user)&mood=classic&apiKey=TU_API_KEY)

StreamElements

!command add !bola8 ${customapi.https://ttv.losperris.dev/api/minigames/magic8?question=${queryescape ${1:}}&user=${user}&mood=classic&apiKey=TU_API_KEY}

Fossabot

!addcmd !bola8 $(customapi https://ttv.losperris.dev/api/minigames/magic8?question=$(querystring)&user=$(user)&mood=classic&apiKey=TU_API_KEY)

Wizebot

!command add !bola8 $(urlfetch https://ttv.losperris.dev/api/minigames/magic8?question=$(arg_1+)&user=$(user_name)&mood=classic&apiKey=TU_API_KEY)

Streamlabs

{readapi.https://ttv.losperris.dev/api/minigames/magic8?question={1:}&user={user.name}&mood=classic&apiKey=TU_API_KEY}

Cambia mood=classic por sarcastic, toxic o helpful según la personalidad que quieras en el chat.