OpenQCoreAI
Loslegen

Ressourcen · Iris-API

Iris-API-Dokumentation

Multimodale Referenz auf Unternehmensniveau für Bildgenerierung, Videoabläufe, OCR, Verifikationspfade, Routing-Regeln und einheitliche Ausgabeverträge.

Zurück zur DokumentationZum Modellkatalog springen

Modellkatalog

iris-orbit

Automatischer Routing-Modus für multimodale Pfade.

iris-genesis

Primäres Modell zur Bildgenerierung.

iris-edit

Pfad zur Bildbearbeitung (Verfügbarkeit abhängig von der Laufzeit).

iris-lens

Bildanalyse und visuelle Interpretation.

iris-video

Workflow zur Videogenerierung.

iris-ocr

Pipeline zur OCR-Extraktion von Dokumenten.

iris-verify

Ablauf zur Identitätsprüfung.

iris-guard

Pfad zur Betrugserkennung (laufzeitabhängig).

iris-face

Pfad zur Gesichtsverifizierung (laufzeitabhängig).

Endpunkte

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

Routing-Logik

  • Die Absicht des Prompts bestimmt den Pfad für Bild, Video, OCR oder Verifizierung.
  • Fallback-Ketten der Anbieter werden angewendet, wenn der primäre Pfad ausfällt.
  • Timeout-Budgets variieren je nach Aufgabentyp (Bild/Video/OCR/Verifizierung).
  • Streaming- und Nicht-Streaming-Pfade teilen sich dieselbe Antworthülle.
  • Nutzungsdaten und Metadaten werden unabhängig vom Anbieter normalisiert.

Anfragebeispiel

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

Antwortvertrag

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

Einheitliche Ausgabefelder

  • success: Kennzeichen des Vorgangsstatus.
  • content: Zusammenfassungs-/Statustext.
  • images/files/videos: modalitätsspezifische Artefakte.
  • usage: normalisiertes Abrechnungs-Payload.
  • metadata: Modell-/Anbieter-/Timing-Diagnostik.

Fehlermodelle

400

Ungültige Nutzlast oder nicht unterstützte Anfrageform.

401

Fehlende oder ungültige Authentifizierung.

413

Eingabe-Payload zu groß.

415

Nicht unterstützter Datei-/Medientyp.

422

Validierungsfehler im Schema oder in Kontext-Headern.

429

Rate-Limit überschritten.

503

Anbieter nicht verfügbar, Timeout oder Systemüberlastung.

Beispiele

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