La API de AIM OMNIA
Imágenes, vídeo, voz, música, 3D y texto desde tu servidor. El precio de cada llamada, en euros, antes de hacerla — sin créditos que convertir, sin cuota mensual. Cada imagen pasa por la revisión: si no la supera, no se cobra.
1. Tu clave
Se crea desde tu cuenta y se ve una sola vez: guardamos su huella, no la clave. Si la pierdes, creas otra y revocas la vieja. Cada clave lleva su propio tope de gasto diario: un bucle mal escrito pierde un día, no tu saldo.
curl -X POST https://www.aim-omnia.ai/api/claves \
-H 'X-Omnia-Session: TU_SESION' -H 'Content-Type: application/json' \
-d '{"nombre":"mi servidor","tope_dia_cents":500}'2. Preguntar el precio antes
Ninguna llamada cobra sin decir antes cuánto. La ficha de una tarea trae sus modelos con el precio exacto y el acierto medido de cada uno.
curl https://www.aim-omnia.ai/api/tarea/imagen -H 'Authorization: Bearer omn_live_...'
3. Crear
curl -X POST https://www.aim-omnia.ai/api/tarea/ejecutar \
-H 'Authorization: Bearer omn_live_...' -H 'Content-Type: application/json' \
-d '{"tarea":"imagen","texto":"un faro rojo al atardecer"}'
{"job_key":"omnia-...","quoted_total_cents":1,"motor":"Económico","espera_seg":6}4. Recoger la creación
curl https://www.aim-omnia.ai/api/job/omnia-... -H 'Authorization: Bearer omn_live_...'
{"status":"completed","output_url":"/outputs/...jpg","price_final_cents":1}Si la revisión no aprueba la creación, otro modelo la rehace gratis; si tampoco sale, price_final_cents es 0. Cada fichero lleva dentro su procedencia (Reglamento UE 2024/1689), comprobable por cualquiera.
5. Todo lo que puedes pedir, con su precio
| tarea | qué hace | desde |
|---|---|---|
escribir | Escribir un texto | 0,01 € |
documento | Redactar un documento | 0,01 € |
buscar | Buscar en la web y responder | 0,02 € |
resumir | Resumir algo largo | 0,01 € |
traducir | Traducir | 0,01 € |
corregir | Corregir y pulir | 0,01 € |
leer_pide una imagen | Leer el texto de una foto | 0,01 € |
explicar | Explicar fácil | 0,01 € |
ideas | Lluvia de ideas | 0,01 € |
codigo | Programar o arreglar código | 0,01 € |
tabla | Sacar datos a tabla | 0,01 € |
preguntar_pide un documento | Preguntar a un documento | 0,01 € |
resumir_pide un documento | Resumir un documento | 0,01 € |
imagen | Crear una imagen | 0,01 € |
quitar_pide una imagen | Quitar el fondo | 0,01 € |
escalarpide una imagen | Mejorar la resolución | 0,01 € |
con_pide una imagen | Un vídeo con tu personaje | 0,30 € |
animarpide una imagen | Animar una imagen | 0,08 € |
modelo3dpide una imagen | Convertir una foto en 3D | 0,02 € |
objeto3d | Crear un objeto en 3D | 0,15 € |
componerpide una imagen | Juntar varias imágenes en una | 0,01 € |
mejorar_pide un vídeo | Mejorar un vídeo | 0,15 € |
escalar_pide un vídeo | Mejorar la resolución de un vídeo | 0,02 € |
extender_pide un vídeo | Alargar un vídeo | 0,50 € |
retocarpide una imagen | Retocar una imagen hablando | 0,01 € |
logo | Diseñar un logo | 0,01 € |
sonido | Crear un efecto de sonido | 0,01 € |
video | Crear un vídeo corto | 0,08 € |
voz | Convertir texto en voz | 0,02 € |
transcribirpide un audio | Transcribir un audio | 0,01 € |
musica | Componer música | 0,20 € |
6. Una campaña entera, o las fotos de tu producto
Lo mismo que en la pantalla, con tu clave. Planificar es gratis y te da el precio cerrado; lanzar lo crea; el estado trae el progreso y, al acabar, cada pieza, el paquete y lo cobrado (nunca más de lo cotizado).
curl -X POST https://www.aim-omnia.ai/api/campana/plan \
-H 'Authorization: Bearer omn_live_...' -H 'Content-Type: application/json' \
-d '{"objetivo":"lanza en redes mi nueva taza de cerámica"}'
curl -X POST https://www.aim-omnia.ai/api/campana/ID/lanzar -H 'Authorization: Bearer omn_live_...'
curl https://www.aim-omnia.ai/api/campana/ID -H 'Authorization: Bearer omn_live_...'Las fotos de un producto parten de su foto real: súbela a /api/subir y pide el plan con ella (/api/producto/plan, campo foto). Cada foto nueva se compara con tu producto: la que no es el mismo, no se cobra.
7. Agencias: cada cliente con su cuenta, en marca blanca
Si trabajas para varios clientes, cada uno puede tener su propia cuenta: su saldo (se lo pasas del tuyo), sus claves con su tope diario, su kit de marca y sus creaciones, sin ver las de los demás. Cada mes, su gasto trabajo a trabajo, para facturarle. Y en marca blanca, lo que entregas va firmado por tu agencia (la marca de contenido hecho con IA del artículo 50 sigue dentro, como pide la ley).
curl -X POST https://www.aim-omnia.ai/api/agencia/clientes \
-H 'Authorization: Bearer omn_live_...' -H 'Content-Type: application/json' \
-d '{"nombre":"Café Luna","marca_blanca":true,"firma":"Tu Agencia"}'
curl -X POST https://www.aim-omnia.ai/api/agencia/clientes/ID/saldo -d '{"cents":2000}' ...
curl -X POST https://www.aim-omnia.ai/api/agencia/clientes/ID/claves -d '{"tope_dia_cents":500}' ...
curl -X POST https://www.aim-omnia.ai/api/agencia/clientes/ID/marca -d '{"nombre":"Café Luna","colores":["#1F4E8C"]}' ...
curl 'https://www.aim-omnia.ai/api/agencia/clientes/ID/informe?mes=2026-09' ...8. Desde tu asistente de IA
AIM OMNIA es también un conector (MCP) para los asistentes de IA que los admiten. Añádelo con esta dirección y pulsa «Conectar»: entras en tu cuenta, eliges cuánto puede gastar al día y vuelves a tu conversación. Sin copiar claves.
https://www.aim-omnia.ai/mcp/conectar
El asistente ve el precio antes de crear, crea cobrando de tu saldo (nunca más de lo que te enseñó) y te trae la creación. Lo desconectas cuando quieras en tu cuenta, en «Tus asistentes y claves». Para programas que ya tienen su clave, la dirección de siempre sigue abierta: https://www.aim-omnia.ai/mcp (leer sin cuenta; crear con Authorization: Bearer omn_live_...). Por dentro: OAuth 2.1 con PKCE y registro dinámico (RFC 9728, 8414 y 7591).
9. Cuando algo va mal
401 | clave inválida o revocada |
402 | sin saldo: no se ha creado nada ni se ha cobrado nada |
403 | esa puerta no acepta una clave: con una clave se crea por /api/tarea/ejecutar y /api/campana/ID/lanzar, que cuentan su tope |
429 | lo pedido no cabe en el tope diario de la clave (el mensaje dice cuánto lleva y cuánto cuesta), o demasiadas llamadas por minuto |
422 | el encargo no se puede hacer con esa tarea; el mensaje lo explica |
Tus creaciones son tuyas y privadas por defecto: nada se publica si no lo pides. El saldo no caduca. AIM OMNIA · el Índice · calidad en vivo · dudas: nexus@biomag.es