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}
El mismo encargo repetido en menos de 90 segundos devuelve el mismo trabajo y no se cobra dos veces: un reintento de tu servidor no te cuesta dinero.

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

tareaqué hacedesde
escribirEscribir un texto0,01 €
documentoRedactar un documento0,01 €
buscarBuscar en la web y responder0,02 €
resumirResumir algo largo0,01 €
traducirTraducir0,01 €
corregirCorregir y pulir0,01 €
leer_imagenpide una imagenLeer el texto de una foto0,01 €
explicarExplicar fácil0,01 €
ideasLluvia de ideas0,01 €
codigoProgramar o arreglar código0,01 €
tablaSacar datos a tabla0,01 €
preguntar_docpide un documentoPreguntar a un documento0,01 €
resumir_docpide un documentoResumir un documento0,01 €
imagenCrear una imagen0,01 €
quitar_fondopide una imagenQuitar el fondo0,01 €
escalarpide una imagenMejorar la resolución0,01 €
con_referenciapide una imagenUn vídeo con tu personaje0,30 €
animarpide una imagenAnimar una imagen0,08 €
modelo3dpide una imagenConvertir una foto en 3D0,02 €
objeto3dCrear un objeto en 3D0,15 €
componerpide una imagenJuntar varias imágenes en una0,01 €
mejorar_videopide un vídeoMejorar un vídeo0,15 €
escalar_videopide un vídeoMejorar la resolución de un vídeo0,02 €
extender_videopide un vídeoAlargar un vídeo0,50 €
retocarpide una imagenRetocar una imagen hablando0,01 €
logoDiseñar un logo0,01 €
sonidoCrear un efecto de sonido0,01 €
videoCrear un vídeo corto0,08 €
vozConvertir texto en voz0,02 €
transcribirpide un audioTranscribir un audio0,01 €
musicaComponer música0,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

401clave inválida o revocada
402sin saldo: no se ha creado nada ni se ha cobrado nada
403esa puerta no acepta una clave: con una clave se crea por /api/tarea/ejecutar y /api/campana/ID/lanzar, que cuentan su tope
429lo 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
422el 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