MIIA — AI Gateway

Compatible con OpenAI SDK

API Documentation

Un solo endpoint, múltiples proveedores gratuitos

Endpoint Principal

Chat completions compatible con OpenAI

POST https://ia.ceballosleon.com/v1/chat/completions

Headers Requeridos

Authorization Bearer mia_xxx...

Content-Type application/json

Ejemplos de Código

curl -X POST https://ia.ceballosleon.com/v1/chat/completions \
  -H "Authorization: Bearer mia_xxx..." \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{"role": "user", "content": "Hola!"}],
    "model": "auto",
    "services": ["groq", "cerebras"],
    "exclude_services": ["gemini"]
  }'

const response = await fetch('https://ia.ceballosleon.com/v1/chat/completions', {
  method: 'POST',
  headers: { 
    'Authorization': 'Bearer mia_xxx...',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    messages: [{ role: 'user', content: 'Hola!' }],
    model: 'groq',
    services: ['groq', 'deepseek']
  })
});

const data = await response.json();
console.log(data.ssid);
console.log(data.choices[0].message.content);

import requests

response = requests.post(
    "https://ia.ceballosleon.com/v1/chat/completions",
    headers={
        "Authorization": "Bearer mia_xxx...",
        "Content-Type": "application/json"
    },
    json={
        "messages": [{"role": "user", "content": "Hola!"}],
        "model": "groq",
        "services": ["groq", "cerebras"]
    }
)

print(response.json()["choices"][0]["message"]["content"])

use Illuminate\Support\Facades\Http;

$response = Http::withToken('mia_xxx...')
    ->post('https://ia.ceballosleon.com/v1/chat/completions', [
        'messages' => [
            ['role' => 'user', 'content' => 'Hola!']
        ],
        'model' => 'groq',
        'services' => ['groq', 'cerebras']
    ]);

echo $response->json('choices.0.message.content');

model: "auto" (orden app) | "groq", "cerebras", "ollama", etc. (priorizar ese servicio) | ID de modelo

Respuesta (JSON)

{
  "id": "chatcmpl-xxx",
  "ssid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "object": "chat.completion",
  "model": "llama-3.3-70b-versatile",
  "service": "groq",
  "choices": [{
    "message": {
      "role": "assistant",
      "content": "¡Hola! ¿Cómo puedo ayudarte?"
    }
  }],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  }
}

Guarda el ssid para consultar después qué se envió, qué respondió el modelo, tokens, costo y motor. Chat, imágenes y audio también lo devuelven.

Requests

Consultar por SSID

Lista las últimas peticiones y recupera qué se mandó, qué respondió, costo y modelo

Cada chat, imagen o audio exitoso (o con error registrado) recibe un ssid UUID. Con tu misma API key puedes listar las últimas X y luego pedir el detalle de una.

Listar las últimas X

GET /v1/requests?limit=20

curl "https://ia.ceballosleon.com/v1/requests?limit=20" \
  -H "Authorization: Bearer mia_xxx..."

limit opcional, 1–100. Default: 20. Solo ves las de tu API key.

{
  "object": "list",
  "data": [
    {
      "ssid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "service": "openai",
      "model": "gpt-image-1.5",
      "success": true,
      "request_type": "image",
      "usage": { "total_tokens": 1664 },
      "estimated_cost": { "label": "$0.133" },
      "created_at": "2026-08-20T21:00:00+00:00"
    }
  ]
}

Pedir una petición

GET /v1/requests/{ssid}

curl https://ia.ceballosleon.com/v1/requests/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer mia_xxx..."

Devuelve lo enviado, la respuesta, tokens, costo aproximado, modelo y servicio.

{
  "ssid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "service": "groq",
  "model": "llama-3.3-70b-versatile",
  "success": true,
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 18,
    "total_tokens": 30
  },
  "estimated_cost": { "label": "$0" },
  "request_data": { /* lo que se mandó */ },
  "response_data": { /* lo que respondió */ }
}

Images

Create image

Crea una imagen a partir de un prompt (compatible con OpenAI Images API)

POST https://ia.ceballosleon.com/v1/images/generations

Igual que en OpenAI: POST /v1/images/generations. Si envías gpt-image-* o dall-e-*, Miia prioriza OpenAI. Sin model, intenta primero proveedores gratuitos. Si la petición incluye imágenes de referencia (image / images), Miia cambia automáticamente a POST /v1/images/edits (OpenAI).

Headers

Authorization Bearer mia_xxx...

Content-Type application/json

Request body

prompt required string

Descripción de la imagen. Máx. 32000 caracteres (GPT Image).

image / images auto → edits file | url | data-url | array

Fotos de producto / referencia. Multipart o JSON. Hasta 16. Si vienen, Miia usa /v1/images/edits con gpt-image-1.5.

input_fidelity optional "low" | "high"

Solo edits / GPT Image. high preserva más detalle de las fotos de referencia.

model optional string

Modelo de imagen. GPT Image: gpt-image-1.5, gpt-image-1. DALL·E: dall-e-3, dall-e-2.

size optional string

Tamaño de la imagen generada. Default: 1024x1024.

1024x1024 1536x1024 1024x1536 1792x1024 1024x1792 auto

GPT Image: 1024x1024, 1536x1024, 1024x1536, auto. DALL·E 3: 1024x1024, 1792x1024, 1024x1792.

quality optional string

Calidad de render. auto deja que el modelo elija.

GPT Image: low · medium · high · auto. DALL·E 3: standard · hd.

background optional "transparent" | "opaque" | "auto"

Solo modelos GPT Image. Fondo transparente, opaco o automático. Con transparent usa output_format png o webp.

output_format optional "png" | "jpeg" | "webp"

Solo modelos GPT Image. Formato de salida. Default: png.

Imagesia · opciones de Qwen Imagen todas opcionales

Al elegir service: "imagesia" / model: "qwen-image", puedes enviar steps (1–40; control creativo, predeterminado 6), seed (−1 aleatoria o 0–2147483647), compute (auto, cpu, gpu, hybrid; predeterminado auto), threads (0–128; 0 automático), transparent (booleano), y fastAttention (booleano). Tamaño predeterminado: 1024x1024. Todos los valores omitidos conservan el predeterminado de Imagesia.

Envía hasta 2 imágenes de referencia en images como data URL base64 PNG/JPEG/WebP (máximo 8 MB por imagen). También admite image. Si hay referencias, Imagesia las usa como guía para generar.

{
  "service": "imagesia", "model": "qwen-image",
  "prompt": "Un gato astronauta en el espacio",
  "size": "1024x1024", "steps": 8, "seed": 42,
  "transparent": true, "compute": "auto", "threads": 0,
  "fastAttention": true, "images": ["data:image/png;base64,..."]
}

Example request

curl https://ia.ceballosleon.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mia_tu_api_key" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "A veterinarian using a stethoscope to listen to the heartbeat of a baby otter, childrens book style.",
    "size": "1024x1024",
    "quality": "high",
    "background": "opaque",
    "output_format": "png"
  }'

Transparent background

curl https://ia.ceballosleon.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mia_tu_api_key" \
  -d '{
    "model": "gpt-image-1.5",
    "prompt": "Logo de tienda, sin fondo",
    "size": "1024x1024",
    "quality": "high",
    "background": "transparent",
    "output_format": "png"
  }'

Respuesta Miia: imágenes en base64 / URL en el formato unificado del gateway. Alternativa: modalities en /v1/chat/completions.

Images

Create image edit

Edita o genera con fotos de referencia (OpenAI /v1/images/edits)

POST https://ia.ceballosleon.com/v1/images/edits

Usa 1–16 imágenes de producto como referencia. Requiere OpenAI (gpt-image-1.5 / gpt-image-1). También puedes llamar a /v1/images/generations con images: Miia redirige aquí automáticamente.

Multipart (recomendado)

curl https://ia.ceballosleon.com/v1/images/edits \
  -H "Authorization: Bearer mia_tu_api_key" \
  -F model=gpt-image-1.5 \
  -F "prompt=Anuncio vertical 9:16 con estos productos" \
  -F size=1024x1536 \
  -F quality=high \
  -F background=opaque \
  -F output_format=png \
  -F input_fidelity=high \
  -F "image[][email protected]" \
  -F "image[][email protected]" \
  -F "image[][email protected]"

Auto-switch desde generations (JSON)

curl https://ia.ceballosleon.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer mia_tu_api_key" \
  -d '{
  "model": "gpt-image-1.5",
  "prompt": "Us these product photos in a Spanish TikTok ad",
  "size": "1024x1536",
  "quality": "high",
  "input_fidelity": "high",
  "images": [
    "https://cdn.example.com/sku1.png",
    "data:image/png;base64,..."
  ]
}'

La respuesta incluye endpoint_used: "/v1/images/edits" cuando aplica el auto-switch.

Modelos compatibles:

gemini-2.0-flash

gemini-2.0-flash-exp:free

gpt-4o-mini

openai/gpt-4o-mini

🖼️ JPEG, PNG, WebP, GIF

📏 Max 10MB/imagen

🔢 Hasta 5 imágenes

🔗 Base64 o URLs

Ejemplo de request:

{
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "¿Qué ves?"},
      {"type": "image_url", 
       "image_url": {"url": "data:image/jpeg;base64,..."}}
    ]
  }],
  "model": "google/gemini-2.0-flash-exp:free"
}

Modelos Whisper disponibles:

whisper-large-v3-turbo

Groq - GRATIS

whisper-large-v3

Groq - GRATIS

whisper-1

OpenAI - Pago

🎵 MP3, WAV, M4A, FLAC

📏 Max 25MB

🌍 98+ idiomas

📝 JSON, SRT, VTT

⚡

Groq ofrece transcripción gratuita y ultra rápida. OpenAI como fallback para mayor precisión.

Ejemplo con cURL:

curl -X POST https://ia.ceballosleon.com/v1/audio/transcriptions \
  -H "Authorization: Bearer mia_xxx..." \
  -F "[email protected]" \
  -F "model=whisper-large-v3-turbo" \
  -F "language=es"

Respuesta:

{
  "text": "Hola, este es un ejemplo...",
  "language": "es",
  "duration": 12.5,
  "service": "groq",
  "model": "whisper-large-v3-turbo",
  "ssid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

POST /v1/audio/speech

Habilita tts en los motores permitidos de tu Mia API key y crea una API key en TTS Server. Configura esa clave en Admin → Provider Keys. El campo voice acepta un id como builtin:NOMBRE o cloned:NOMBRE. En el servidor TTS, GET /v1/voices lista voces disponibles.

Opcionales: model (xtts-v2), language (es), speed (0.5–2), y response_format (mp3, wav, opus, aac, flac, pcm; predeterminado mp3). Texto máximo: 50 000 caracteres, sujeto además a los límites administrados por TTS Server.

Ejemplo cURL

curl https://ia.ceballosleon.com/v1/audio/speech \
  -H "Authorization: Bearer mia_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"xtts-v2","input":"Hola desde MIIA","voice":"builtin:NOMBRE","language":"es","response_format":"mp3"}' \
  --output speech.mp3

La respuesta es el audio binario; incluye el identificador de petición en X-Request-Id.

¿Cómo obtener tu API Key?

Inicia sesión en el panel de administración para crear tus propias API Keys. Cada key puede filtrar servicios específicos y tiene acceso a todos los proveedores configurados.

🔐 Acceder al Panel

Un endpoint. Todas las IAs.

¿Por qué es gratis?

Rotación Inteligente

Sin Tarjeta de Crédito

Alta Velocidad

Cómo Funciona

Tu Petición

Round Robin

Procesamiento IA

Respuesta Stream

Proveedores Soportados

Groq

Cerebras

Google AI Studio (Gemini)

OpenRouter

Cloudflare Workers AI

Cohere

Mistral AI

NVIDIA NIM

Ollama

SiliconFlow

Novita AI

Vercel AI Gateway

Z.AI (Zhipu GLM Flash)

SambaNova

Hugging Face

Pollinations

Routeway AI

OmniRoute

DeepSeek

Imagesia · Qwen Imagen

OpenAI

TTS Server · XTTS-v2