Risorse · Iris API

Documentazione dell'API Iris

Riferimento multimodale di livello enterprise per generazione di immagini, flussi video, OCR, percorsi di verifica, regole di instradamento e contratti di output unificati.

Torna alla documentazione Vai al Catalogo dei Modelli

Catalogo modelli

iris-orbit

Modalità di instradamento automatico attraverso canali multimodali.

iris-genesis

Modello principale per la generazione di immagini.

iris-edit

Percorso di modifica delle immagini (la disponibilità dipende dal runtime).

iris-lens

Analisi delle immagini e interpretazione visiva.

iris-video

Flusso di lavoro per la generazione di video.

iris-ocr

Pipeline di estrazione OCR per documenti.

iris-verify

Flusso di verifica dell'identità.

iris-guard

Fraud detection path (runtime-dependent).

iris-face

Face verification path (runtime-dependent).

Endpoint

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

Logica di instradamento

Prompt intent determines image, video, OCR, or verification lane.
Provider fallback chains are applied when primary path fails.
Timeout budgets vary by task type (image/video/OCR/verify).
Streaming and non-streaming paths share the same response envelope.
Usage and metadata are normalized regardless of provider.

Esempio di richiesta

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]"
  }
}

Contratto di risposta

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
  }
}

Campi di output unificati

success: operation status flag.
content: summary/status text.
images/files/videos: modality-specific artifacts.
usage: normalized accounting payload.
metadata: model/provider/timing diagnostics.

Modelli di errore

400

Invalid payload or unsupported request shape.

401

Missing or invalid authentication.

413

Input payload too large.

415

Unsupported file/media type.

422

Validation failure in schema or context headers.

429

Rate limit exceeded.

503

Provider unavailable, timeout, or system overload.

Esempi

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
  }'