Documentación

CodexAeternum

Referencia completa de la plataforma: API para desarrolladores y manuales de cada herramienta. Usá el índice de la izquierda para navegar.

API para Desarrolladores
General

Autenticación y créditos

  • Todas las llamadas (salvo el intercambio de token) requieren el session_token, enviado en el encabezado Session-Token o como campo session_token del cuerpo.
  • El cuerpo puede enviarse como application/json o como formulario.
  • Generar, editar y describir imágenes consume 1 crédito por llamada. La respuesta incluye credits con el saldo restante.
  • Sin créditos disponibles, la API responde 200 con {"message": "Creditos Insuficientes"}.
  • Si el token falta o es inválido, la API responde 401 con {"error": "Autenticación requerida"}.

Antes de consumir la API, iniciá sesión con el correo que utilizarás y obtené el secret token desde tu Perfil.

Auth

Intercambio de token

Endpoint POST /login/tokenexchange/

Enviá en el cuerpo stoken y email de un usuario registrado para recibir un session_token que se usará para autenticar el resto de las solicitudes.

{
  "session_token": "b7ced25a045b6f55d5aaef14064b420b"
}
  • 400: falta email o stoken.
  • 401: stoken inválido o expirado.
Imágenes

Generar, editar o describir imagen

Endpoint POST /api/dev/image/

Un único endpoint que interpreta el prompt y decide qué hacer: generar una imagen nueva, editar una existente o describirla. Es sincrónico: cuando la respuesta llega, la imagen ya está lista para descargarse con task_id.

Parámetros del cuerpo:

  • prompt (obligatorio): qué querés hacer. Ej.: "un logo minimalista de un búho", "quitá el auto del fondo", "¿qué hay en esta imagen?".
  • image_base64 (opcional): imagen de entrada para editar o describir, con o sin prefijo data:image/...;base64,.
  • prev_task_id (opcional): task_id de una imagen generada antes, para seguir editándola en pasos sucesivos sin volver a subirla.

Operaciones detectadas por intent:

Generación (sin imagen de entrada):

generate design_logo render_text comic_strip ui_preview slides_chart scientific historical explain_process

Edición (con image_base64 o prev_task_id):

refine remove_object change_clothing style_transfer transparent_cutout drawing_to_realistic insert_person translate_layout combine_refs

Descripción (con imagen de entrada): describe — la respuesta incluye description.

Respuesta:

{
  "task_id": "MV8xNzUwNjEzMTU2LjU2NDExMjRfLmpwZw==",
  "path_image": "MV8xNzUwNjEzMTU2LjU2NDExMjRfLmpwZw==",
  "destination": "MV8xNzUwNjEzMTU2LjU2NDExMjRfLmpwZw==",
  "intent": "remove_object",
  "credits": 54
}
  • task_id / destination: identificador de la imagen resultante; usalo para obtenerla o como prev_task_id en la próxima edición.
  • intent: operación que se ejecutó.
  • description: solo cuando intent es describe.
  • 400: prompt vacío o describir sin imagen. 503: servicio temporalmente no disponible.

Ejemplo: generar y después editar la misma imagen:

import requests

BASE_URL = "https://codexaeternum.com"
headers = {"Session-Token": "b7ced25a045b6f55d5aaef14064b420b"}

# 1. Generar
r1 = requests.post(f"{BASE_URL}/api/dev/image/", headers=headers,
    json={"prompt": "una casa de campo al atardecer, estilo acuarela"}).json()

# 2. Editar la imagen anterior
r2 = requests.post(f"{BASE_URL}/api/dev/image/", headers=headers,
    json={"prompt": "hacé el cielo nocturno con estrellas",
          "prev_task_id": r1["task_id"]}).json()

# 3. Descargar el resultado
img = requests.get(f"{BASE_URL}/api/dev/image/", headers=headers,
    params={"task_id": r2["task_id"]}).json()
image_base64 = img[r2["task_id"]]
Imágenes

Obtener imagen

Endpoint GET /api/dev/image/?task_id=<task_id>

Agrega el encabezado Session-Token y el parámetro task_id. Devuelve un JSON donde la clave es el task_id y el valor la imagen codificada en base64.

{
  "MV8xNzUwNjEzMTU2LjU2NDExMjRfLmpwZw==": "<imagen_en_base64>"
}
Descripción

Describir imagen (endpoint legacy)

Endpoint POST /describe_image/

Analiza una imagen y responde en español sobre lo que se ve. A diferencia de POST /api/dev/image/, siempre describe (nunca edita) y el prompt es opcional.

Parámetros del cuerpo:

  • image_base64 (obligatorio): imagen codificada en base64, con o sin prefijo. Recomendado: hasta 5 MB.
  • prompt (opcional): instrucción o pregunta sobre la imagen. Si se omite, se devuelve una descripción detallada.
{
  "description": "La imagen muestra una cordillera al atardecer...",
  "task_id": "MV8xNzUwNjEzMTU2LjU2NDExMjRfLmpwZw==",
  "intent": "describe",
  "credits": 54
}

Ejemplo:

import base64, requests

BASE_URL = "https://codexaeternum.com"
session_token = "b7ced25a045b6f55d5aaef14064b420b"

with open("montanas.jpg", "rb") as f:
    image_base64 = base64.b64encode(f.read()).decode("utf-8")

response = requests.post(f"{BASE_URL}/describe_image/",
    headers={"Session-Token": session_token},
    json={"prompt": "¿cuántas montañas hay?", "image_base64": image_base64})

data = response.json()
print(data["description"])
print("Créditos restantes:", data["credits"])
  • 400: falta image_base64.
Herramientas de la plataforma
Herramienta

Crea y edita imágenes con IA

Chat unificado que genera imágenes nuevas, edita imágenes existentes y las analiza, todo desde una sola pantalla. El sistema detecta automáticamente qué hacer según lo que escribís. Consume 1 crédito por acción.

Acceso: ingresá a Herramientas y luego a Crear imágenes.

Tipos de generación:

  • Imagen general: cualquier escena, retrato, paisaje u objeto.
  • Logo (design_logo): fondo transparente automático.
  • Texto legible (render_text): el texto pedido aparece exacto y legible.
  • Proceso paso a paso (explain_process): visual numerado con iconos y flechas.
  • Tira cómica (comic_strip), mockup de UI (ui_preview), diagrama científico (scientific), gráfico para presentación (slides_chart), escena histórica (historical).

Tipos de edición (requieren imagen adjunta o imagen previa generada en la sesión):

  • Refinamiento (refine): ajuste fino de la imagen existente.
  • Cambio de ropa (change_clothing): sin alterar cara ni identidad.
  • Fondo transparente (transparent_cutout): aísla el sujeto.
  • Dibujo a foto realista (drawing_to_realistic).
  • Quitar objeto (remove_object), insertar persona (insert_person), transferir estilo (style_transfer), combinar referencias (combine_refs), traducir texto en imagen (translate_layout).

Multi-turno: después de generar una imagen, escribís el siguiente ajuste directamente sin readjuntar — el sistema usa la última imagen generada en la sesión. Para adjuntar una imagen propia usá el clip o arrastrá y soltá sobre la pantalla.

Historial: las imágenes generadas o editadas se guardan en el panel lateral con etiqueta Imagen, Edición o Descripción. Hacé clic sobre cualquier imagen para ampliarla y descargarla.

Herramienta

Descripción y análisis de imágenes

Función integrada en la misma pantalla de creación de imágenes. Adjuntás una imagen, escribís lo que querés saber y el sistema responde con texto usando GPT-4o Vision. Consume 1 crédito por análisis.

Acceso: ingresá a Herramientas y luego a Describir imágenes (o Crear imágenes: es la misma pantalla).

Qué puede analizar:

  • Descripción general: qué hay en la imagen, colores, escena, ambiente.
  • Extracción de texto (OCR): leer texto de señales, documentos, capturas de pantalla.
  • Identificación y conteo de objetos, categorías o marcas.
  • Análisis de gráficos, tablas o datos numéricos en la imagen.
  • Interpretación de diagramas, planos, esquemas o capturas de UI.
  • Preguntas concretas: "¿cuántas personas hay?", "¿qué dice el cartel?".

Cómo activarlo: adjuntá la imagen (clip o drag and drop) y escribí algo que indique descripción o análisis ("describí", "¿qué hay en…", "extraé el texto", "¿qué muestra el gráfico?"). Si el prompt parece un pedido de cambio, el sistema edita la imagen en vez de describirla.

Limitación: no identifica personas específicas por nombre (política del servicio de IA).

Herramienta

Análisis inteligente de video

Permite subir videos y hacer preguntas sobre su contenido. La IA procesa los frames del video y responde en lenguaje natural.

Acceso: ingresá a Herramientas y luego a Análisis de video.

Cómo usar:

  1. Ingresá a Análisis de video.
  2. Subí el video con la opción de carga y esperá la confirmación.
  3. Seleccioná el video desde el historial.
  4. Escribí tu consulta (ej.: "detectá personas en la escena", "¿qué pasa en el minuto 2?").
  5. Ejecutá el procesamiento y revisá la respuesta.

Buenas prácticas:

  • Hacé consultas acotadas a una escena o momento específico.
  • Pedí una sola tarea por consulta para mayor precisión.
  • Si el video es largo, dividilo por segmentos.
  • Usá buena calidad de imagen para mejores resultados.

Errores comunes:

  • Carga fallida: revisá tamaño, formato y conectividad.
  • Resultado pobre: ajustá el prompt con más contexto temporal.
  • Timeouts: reintentá con un clip más corto.
Herramienta

Streaming de cámaras de video

Analiza cuadros de video en vivo o flujos de cámaras para detectar eventos relevantes. Permite monitoreo continuo con historial por cámara.

Acceso: ingresá a Herramientas y luego a Streaming de cámaras.

Cómo usar:

  1. Ingresá a Streaming de cámaras.
  2. Registrá o seleccioná una cámara.
  3. Verificá que la fuente esté activa.
  4. Definí tu consulta (ej.: "detectar movimiento sospechoso", "¿hay personas en el área?").
  5. Ejecutá el procesamiento y consultá el historial de resultados.

Buenas prácticas:

  • Usá cámaras con buena iluminación.
  • Separar detección de personas, objetos y eventos en consultas distintas.
  • Revisá periódicamente el historial para continuidad del monitoreo.

Errores comunes:

  • Cámara no disponible: validá conectividad y origen del stream.
  • Sin resultados: mejorá la calidad del stream o reformulá el prompt.
  • Latencia alta: reducí la complejidad de la consulta.
Herramienta

Forobot

Foros temáticos asistidos por IA: la comunidad hace consultas, responde, vota y la IA modera y sugiere respuestas automáticas.

Acceso: ingresá a Herramientas y luego a Forobot.

Roles disponibles:

  • Owner: administración total.
  • Moderador: revisión y gestión de contenido.
  • Miembro: participación según whitelist.

Cómo usar:

  1. Entrá a Forobot y creá un forobot nuevo o ingresá a uno existente.
  2. Creá una consulta nueva o respondé una existente.
  3. Votá y marcá respuestas aceptadas para mejorar la calidad.
  4. En cualquier hilo, mencioná @forobot para pedir una nueva intervención de la IA sobre ese punto específico.
  5. Moderá contenido desde el panel de administración del forobot.

Flujo de IA: la IA clasifica preguntas, sugiere y puede automatizar respuestas. Las respuestas aprobadas enriquecen la base de conocimiento del asistente.

Buenas prácticas:

  • Definí la temática claramente al crear el forobot.
  • Usá @forobot para aclaraciones o ampliaciones dentro del mismo hilo, no para abrir temas nuevos.
  • Revisá periódicamente solicitudes de miembros y moderadores.
Herramienta

Chatbot CodexAeternum P2P (widget)

Widget flotante de chat que permite al usuario hacer preguntas directas a la IA desde cualquier página de la plataforma que tenga el widget habilitado.

Cómo funciona:

  1. El usuario abre el widget flotante (esquina inferior derecha).
  2. Escribe su pregunta y presiona Enviar.
  3. La IA genera una respuesta en lenguaje natural en pocos segundos.
  4. La respuesta aparece en la conversación del widget.

Buenas prácticas:

  • Formulá preguntas claras y concretas.
  • El asistente orienta sobre el uso del producto; para facturación, acceso o incidencias, usá los canales de soporte de la plataforma.

Manejo de errores:

  • Mensaje vacío: el sistema pide que escribas tu consulta.
  • Sin respuesta temporal: invita a reintentar en unos segundos.
  • Error de conexión: mensaje amigable con opción de reintento.
Herramienta

FAQs — Preguntas frecuentes

Preguntas frecuentes de la plataforma CodexAeternum, disponibles para usuarios, clientes y desarrolladores.

Preguntas frecuentes principales:

  • ¿Cómo funcionan los planes? Los planes se ofrecen como suscripción con créditos incluidos y se renuevan mes a mes. Los ves y contratás en Precios; el detalle de tu plan está en tu Perfil.
  • ¿Puedo cancelar en cualquier momento? Sí, desde tu Perfil.
  • ¿Qué son los créditos? La unidad de uso para ejecutar acciones que consumen IA (generar imágenes, analizar videos, etc.). Los planes incluyen una cantidad de créditos; para recargar, entrá a Precios.
  • ¿Por qué no puedo comprar un plan? Necesitás sesión iniciada para contratar desde Precios. Si ya estás logueado y no podés avanzar, contactá soporte.
  • ¿Puedo usar las imágenes con fines comerciales? Revisá los Términos y condiciones antes de usar imágenes en campañas o productos.
  • ¿Qué pasa con mis datos personales? CodexAeternum trata datos personales de forma acotada para operar tu cuenta. El detalle está en Términos y condiciones.
  • ¿El asistente de chat reemplaza al soporte humano? No. El chat orienta sobre el uso del producto; para casos de facturación o acceso, usá los canales de soporte de la web.
Herramienta · Beta

Prometeo

Chat privado con IA especializado en un tópico (área de conocimiento con documentación propia de la plataforma, por ejemplo normativa eléctrica o legislación). Prometeo busca en la documentación del tópico y muestra las fuentes que usó y sus limitaciones. Disponible solo para Argentina (suscripción en ARS).

Acceso: ingresá a Herramientas y luego a Prometeo. Necesitás la prueba gratis o la suscripción activa; si no la tenés, la plataforma te lleva a tu Perfil para activarla.

Formas de acceso:

  • Prueba gratis de 7 días: para usuarios que nunca usaron Prometeo. Sin tarjeta ni datos adicionales. Una sola vez por cuenta.
  • Suscripción mensual paga: con Mercado Pago (ARS). El acceso se activa cuando Mercado Pago aprueba la suscripción.

Cómo empezar:

  1. Entrá a tu Perfil, sección Prometeo.
  2. Elegí un tópico en el selector.
  3. Tocá "Probar 7 días gratis" o "Suscribirse a Prometeo".
  4. Ingresá a Herramientas y luego a Prometeo.

Características del chat:

  • Conversaciones con historial (el agente recuerda lo hablado dentro de cada conversación).
  • Etapas visibles mientras procesa: "Buscando en la documentación", "Redactando la respuesta", etc.
  • Fuentes debajo de cada respuesta: nombre del documento, página y artículo.
  • Advertencias "Ojo:…" cuando la documentación no cubre algo.
  • Fórmulas matemáticas renderizadas (LaTeX).
  • Panel lateral con lista de conversaciones; en mobile, se convierte en drawer.

Tiempos de respuesta: preguntas puntuales 15–40 s; análisis argumentativo 90–180 s. Timeout a los 3 min 30 s.

Cancelación: botón "Cancelar Prometeo" en tu Perfil. Al cancelar no se borra nada; las conversaciones quedan disponibles al volver a suscribirse.