POST https://akiomae.xyz/api/AI/AkioIA/

AkioIA API

Una potente API de inteligencia artificial con sistema de 21 modelos en cascada, memoria conversacional, generación de imágenes, música, video, TTS, búsqueda web integrada y soporte nativo para bots de Discord.

Modelos IA

Comandos Mágicos

Proveedores

∞

Chats Simultáneos

🔗 Endpoint

Única URL base para todas las interacciones.

HTTP

POST https://akiomae.xyz/api/AI/AkioIA/
Content-Type: application/json
Accept: application/json

ℹ️ Solo se acepta el método POST. Las peticiones GET o de otros métodos serán rechazadas con HTTP 405.

⚙️ Parámetros del Body

Envía un JSON con los siguientes campos en el cuerpo de la petición.

Campo	Tipo	Estado	Descripción
id	string	Requerido	Identificador único del chat/sesión. Determina qué historial de memoria se carga. Usa un ID único por conversación (ej: `user_123_chat_1`).
username	string	Requerido	Nombre del usuario que interactúa. Se usa en el contexto de la IA.
context	string	Requerido	Instrucciones del sistema para la IA. Define el rol, comportamiento y limitaciones del asistente. Equivale al "system prompt".
personality	string	Requerido	Descripción de la personalidad del asistente. Ej: "Amable, profesional y entusiasta".
name	string	Requerido	Nombre del asistente IA. La IA responderá como este personaje.
prompt	string	Requerido	El mensaje o pregunta del usuario en esta vuelta del chat.
genero	string	Requerido	Género del asistente para coherencia gramatical. Valores: `MASCULINO` · `FEMENINO` · `ALEATORIO`
nsfw	boolean	Opcional	Activa/desactiva filtros de contenido para adultos. Default: `false`. Si es `true`, la IA procesa cualquier tipo de contenido.
tokens	integer	Opcional	Límite máximo de tokens en la respuesta. 1 token ≈ 4 caracteres. Ej: `1500` ≈ 6,000 caracteres máximos de respuesta.
lang	string	Opcional	Idioma principal del asistente. Default: `"Español"`. La IA se adapta automáticamente al idioma del usuario.
tokenBot	string	Solo Discord	Token del bot de Discord. Activa el modo Discord-Bot, donde la IA envía mensajes y archivos directamente al canal.
channelID	string	Solo Discord	ID del canal de Discord donde el bot publicará los mensajes de estado y respuestas.

📤 Ejemplo de Solicitud

Body JSON mínimo para iniciar una conversación.

JSON – Body

{
  "id":          "usuario_123",
  "username":    "nombre_usuario",
  "context":     "Eres un asistente amable que ayuda con preguntas técnicas",
  "personality": "Amable, profesional y entusiasta",
  "name":        "Asistente",
  "prompt":      "¿Cuál es la capital de Japón?",
  "genero":      "MASCULINO",
  "nsfw":        false,
  "tokens":      1500
}

cURL

curl -X POST https://akiomae.xyz/api/AI/AkioIA/ \
  -H "Content-Type: application/json" \
  -d '{
    "id":"usuario_123",
    "username":"Juan",
    "context":"Eres un asistente servicial",
    "personality":"Amable y curioso",
    "name":"AkioIA",
    "prompt":"Cuéntame algo interesante",
    "genero":"MASCULINO",
    "nsfw":false
  }'

📥 Tipos de Respuesta

La API detecta automáticamente qué tipo de respuesta devolver según lo que el usuario pida.

💬

Respuesta de Texto

Conversación normal, preguntas y respuestas.

{
  "id": "usuario_123",
  "response": "¡La capital de Japón es Tokio! Es una de las ciudades más grandes del mundo...",
  "modelo_usado": "AK-v3.5-BETA"
}

🔍

Búsqueda de Imágenes

Devuelve hasta 4 URLs de imágenes encontradas.

{
  "id": "usuario_123",
  "response": "Mira lo que encontré: imágenes de gatitos",
  "modelo_usado": "AK-v2.8",
  "media_urls": {
    "image1": "https://ejemplo.com/gato1.jpg",
    "image2": "https://ejemplo.com/gato2.jpg",
    "image3": "https://ejemplo.com/gato3.jpg",
    "image4": "https://ejemplo.com/gato4.jpg"
  }
}

🎨

Imagen Generada por IA

Pollinations AI genera la imagen con el prompt mejorado.

{
  "id": "usuario_123",
  "response": "",
  "modelo_usado": "AK-v2.8",
  "media_urls": {
    "image1": "https://image.pollinations.ai/prompt/A+cat+astronaut..."
  }
}

💻

Código Generado

Bloques de código en archivos separados por lenguaje.

{
  "id": "usuario_123",
  "response": "Aquí está tu página web:\n[📎 Código adjunto en archivo: code_block_1.html]",
  "modelo_usado": "AK-v2.8",
  "code_files": {
    "code1": {
      "filename": "code_block_1.html",
      "language": "html",
      "content": "<!DOCTYPE html>..."
    }
  }
}

🎙️

Audio TTS

Archivo de voz generado y URL de acceso.

{
  "id": "usuario_123",
  "response": "🎙️ Nota de voz generada",
  "modelo_usado": "AK-v3.5-BETA",
  "audio_url": "https://akiomae.xyz/api/AI/AkioIA/media/tts_abc.mp3"
}

🎵

Música Generada

Pista de música generada con IA vía Pollinations.

{
  "id": "usuario_123",
  "response": "🎵 Música generada: upbeat lo-fi study beat",
  "modelo_usado": "AK-v3.5-BETA",
  "audio_url": "https://akiomae.xyz/api/AI/AkioIA/media/music_xyz.mp3"
}

🎬

Video Generado

Video MP4 generado con IA vía Pollinations.

{
  "id": "usuario_123",
  "response": "🎬 Video generado exitosamente",
  "modelo_usado": "AK-v3.5-BETA",
  "video_url": "https://akiomae.xyz/api/AI/AkioIA/media/video_abc.mp4"
}

✨ Comandos Mágicos de la IA

La IA detecta automáticamente la intención del usuario y activa el comando correspondiente. No necesitas escribir los comandos manualmente, la IA los genera internamente.

✅ Solo necesitas hacer una solicitud normal en lenguaje natural. Por ejemplo: "Genera una imagen de un gato astronauta", y la IA activará el comando correcto automáticamente.

generate_imageIA Generativa

Genera una imagen con IA usando Pollinations cuando el usuario pide crear, dibujar o generar una imagen. La IA mejora automáticamente el prompt en inglés antes de generarla.

Usuario: "Genera una imagen de un dragón volando sobre una ciudad futurista"
→ Activa: generate_image A majestic dragon soaring over a neon-lit futuristic cityscape, 4k, cinematic...

search_internet

Realiza una búsqueda web en tiempo real y procesa los resultados para darte una respuesta organizada con fuentes y links relevantes.

Usuario: "Busca información sobre el volcán Fuji"
→ Activa: search_internet volcán Fuji información

search_image

Busca imágenes en internet y devuelve hasta 4 URLs de imágenes reales encontradas.

Usuario: "Muéstrame fotos de gatitos tiernos"
→ Activa: search_image gatitos tiernos

search_link

Visita un URL específico, extrae su contenido y lo resume para el usuario. Ideal para analizar artículos, documentos o páginas web.

Usuario: "Revisa este artículo: https://ejemplo.com/noticia"
→ Activa: search_link https://ejemplo.com/noticia

TTS_GENERATEDVoz IA

Convierte texto a voz realista. Usa ElevenLabs como primer intento (alta calidad) y Google Translate TTS como respaldo. El audio se sube como archivo MP3.

Usuario: "Mándame una nota de voz presentándote"
→ Activa: TTS_GENERATED Hola, soy AkioIA, tu asistente personal...

GENERATE_MUSICMúsica IA

Genera música original con IA usando Pollinations (ElevenLabs Music). Devuelve un archivo MP3 de hasta 30 segundos. Completamente gratuito, sin límite de canciones.

Usuario: "Crea una melodía relajante de jazz para estudiar"
→ Activa: GENERATE_MUSIC A relaxing jazz melody with soft piano and gentle drums, perfect for studying, lo-fi vibes

GENERATE_VIDEOVideo IA

Genera un video corto (MP4) con IA usando Pollinations. Soporta múltiples modelos: veo, seedance, wan, grok-video, ltx-2. Completamente gratuito.

Usuario: "Genera un video de un gato nadando entre corales de neón"
→ Activa: GENERATE_VIDEO A cute cat swimming underwater among neon glowing corals, 4k cinematic, highly detailed

🤖 Sistema de 21 Modelos en Cascada

La API intenta cada modelo en orden de prioridad. Si uno falla, pasa automáticamente al siguiente. Esto garantiza respuesta casi siempre.

⚡ El campo modelo_usado en la respuesta indica qué modelo respondió. Los nombres AK-vX.X son alias internos.

AK-v3.5-BETA

Google

Gemini 2.5 Flash Lite

Principal

AK-v3.4

OpenRouter

DeepSeek Chat

AK-v3.3

OpenRouter

Llama 3.3 70B

AK-v3.2

OpenRouter

Mistral 7B

AK-v3.1

OpenRouter

Gemini 2.5 Pro

AK-v3.0

OpenRouter

Claude 3 Haiku

AK-v2.9

Groq

Llama 3.3 70B Versatile

AK-v2.8

Groq

Llama 3.1 8B Instant

AK-v2.7

Groq

Llama 3.2 1B Preview

AK-v2.6

Groq

Llama 3.2 3B Preview

AK-v2.5

Groq

Mixtral 8x7B

#10

AK-v2.4

Cerebras

Llama 3.3 70B

#11

AK-v2.3

Cerebras

Llama 3.1 8B

#12

AK-v2.2

Cerebras

Qwen 3 32B

#13

AK-v2.1

Cohere

Command R+ (Aug 2024)

#14

AK-v2.0

Cohere

Command R (Aug 2024)

#15

AK-v1.9

Cohere

Command A (Mar 2025)

#16

AK-v1.8

Cohere

Command Standard

#17

AK-v1.7

Cohere

Command Light

#18

AK-v1.6

Anthropic

Claude 3 Haiku

#19

AK-v1.5

Anthropic

Claude 3.5 Haiku

#20

🧠 Sistema de Memoria Conversacional

La API recuerda conversaciones anteriores usando el campo id como clave de sesión.

⚠️ Usa un ID diferente por cada conversación distinta. Usuarios distintos con el mismo ID compartirán historial.

Almacena hasta 10 mensajes del historial reciente.
Límite inteligente de 15,000 caracteres (~4,000 tokens) de contexto. Si el historial excede el límite, se truncan los mensajes más antiguos automáticamente.
El historial se guarda en archivos .json en el servidor, identificados por el id de sesión.
Para reiniciar la memoria, simplemente usa un nuevo id único.

💬 Modo Discord Bot

Añade tokenBot y channelID para activar el modo Discord. El bot enviará mensajes de estado en tiempo real y publicará las respuestas directamente en el canal.

JSON – Con Discord

{
  "id":          "guild_123_user_456",
  "username":    "DiscordUser",
  "context":     "Eres un asistente de Discord divertido",
  "personality": "Energético y gracioso",
  "name":        "AkioBot",
  "prompt":      "Genera una imagen de un samurái en el espacio",
  "genero":      "MASCULINO",
  "tokenBot":    "MTA5...tu_token_de_bot",
  "channelID":   "123456789012345678"
}

💡 En modo Discord, el bot:
• Publica un mensaje animado de "Analizando..." que va actualizando conforme procesa.
• Envía imágenes, audio y video como archivos adjuntos directamente en el canal.
• Divide mensajes largos (más de 2,000 caracteres) automáticamente.
• Al finalizar, elimina el mensaje de estado y publica la respuesta final.

🖼️ Análisis de Imágenes (Multimodal)

Gemini puede "ver" imágenes si incluyes URLs de imágenes directamente en el prompt.

Ejemplo

// En el campo "prompt", incluye una URL de imagen:
"prompt": "¿Qué hay en esta imagen? https://ejemplo.com/foto.jpg"

✅ Soporta formatos: .jpg, .jpeg, .png, .webp, .gif. Si Gemini falla, los modelos de respaldo procesan solo el texto.

❌ Códigos de Error

HTTP Code	Error	Causa
400	`Falta el campo 'X'`	Un campo requerido no fue enviado en el body.
400	`El campo genero debe ser...`	El valor de `genero` no es MASCULINO, FEMENINO o ALEATORIO.
405	`Método no permitido`	Se usó GET u otro método en lugar de POST.
500	`Respuesta vacía del modelo`	La IA respondió pero el contenido estaba vacío.
503	`Todos los servicios no disponibles`	Los 21 modelos fallaron simultáneamente. Muy raro. Reintenta en 1 min.