Recursos · API Iris

Documentación de la API Iris

Referencia multimodal de nivel empresarial para generación de imágenes, flujos de vídeo, OCR, rutas de verificación, reglas de enrutamiento y contratos de salida unificados.

Volver a la documentación Ir al catálogo de modelos

Catálogo de modelos

iris-orbit

Modo de enrutamiento automático a través de carriles multimodales.

iris-genesis

Modelo principal de generación de imágenes.

iris-edit

Ruta de edición de imágenes (la disponibilidad depende del tiempo de ejecución).

iris-lens

Análisis de imágenes e interpretación visual.

iris-video

Flujo de trabajo de generación de vídeo.

iris-ocr

Proceso de extracción OCR de documentos.

iris-verify

Flujo de verificación de identidad.

iris-guard

Ruta de detección de fraude (dependiente del tiempo de ejecución).

iris-face

Ruta de verificación facial (dependiente del tiempo de ejecución).

Puntos finales

POST /api/v1/iris/generate-image

POST /api/v1/iris/edit-image

POST /api/v1/iris/analyze-image

POST /api/v1/iris/generate-video

POST /api/v1/iris/ocr

POST /api/v1/iris/verify

Lógica de enrutamiento

La intención del prompt determina la vía de imagen, vídeo, OCR o verificación.
Se aplican cadenas de respaldo del proveedor cuando falla la ruta primaria.
Los presupuestos de tiempo de espera varían según el tipo de tarea (imagen/vídeo/OCR/verificación).
Las rutas de transmisión y no transmisión comparten el mismo envoltorio de respuesta.
El uso y los metadatos se normalizan independientemente del proveedor.

Ejemplo de solicitud

json

{
  "model": "iris-genesis",
  "prompt": "A futuristic city skyline at sunrise, cinematic lighting",
  "size": "1024x1024",
  "quality": "high",
  "stream": false,
  "metadata": {
    "workspace_id": "[workspace_uuid]",
    "trace_id": "[trace_id]"
  }
}

Contrato de respuesta

json

{
  "success": true,
  "content": "Generation completed",
  "provider": "openai",
  "images": [
    { "url": "https://...", "mime_type": "image/png" }
  ],
  "files": [],
  "videos": [],
  "usage": {
    "input_tokens": 0,
    "output_tokens": 0
  },
  "metadata": {
    "model": "iris-genesis",
    "duration_ms": 1542
  }
}

Campos de salida unificados

success: indicador de estado de la operación.
content: texto de resumen/estado.
images/files/videos: artefactos específicos de la modalidad.
usage: paquete de contabilidad normalizado.
metadata: diagnósticos de modelo/proveedor/temporización.

Modelos de error

400

Carga inválida o formato de solicitud no compatible.

401

Autenticación ausente o inválida.

413

Carga de entrada demasiado grande.

415

Tipo de archivo/medio no compatible.

422

Fallo de validación en el esquema o en las cabeceras de contexto.

429

Límite de tasa excedido.

503

Proveedor no disponible, tiempo de espera agotado o sobrecarga del sistema.

Ejemplos

bash

curl -X POST "/api/v1/iris/generate-image" \
  -H "Authorization: Bearer [token]" \
  -H "Content-Type: application/json" \
  -H "X-Scope-Type: workspace" \
  -H "X-Workspace-ID: [workspace_uuid]" \
  -d '{
    "model":"iris-genesis",
    "prompt":"A modern AI control room dashboard",
    "stream":false
  }'