Ressources · API Iris

Documentation de l'API Iris

Référence multimodale de niveau entreprise pour la génération d'images, les flux vidéo, l'OCR, les parcours de vérification, les règles de routage et les contrats de sortie unifiés.

Retour à la documentation Aller au catalogue de modèles

Catalogue de modèles

iris-orbit

Mode d'acheminement automatique entre les voies multimodales.

iris-genesis

Modèle principal de génération d'images.

iris-edit

Parcours d'édition d'images (disponibilité selon l'environnement d'exécution).

iris-lens

Analyse d'images et interprétation visuelle.

iris-video

Flux de génération vidéo.

iris-ocr

Pipeline d'extraction OCR de documents.

iris-verify

Flux de vérification d'identité.

iris-guard

Voie de détection de fraude (dépendante de l'exécution).

iris-face

Voie de vérification du visage (dépendante de l'exécution).

Points de terminaison

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

Logique de routage

L'intention de l'invite détermine la voie image, vidéo, OCR ou vérification.
Des chaînes de repli de fournisseurs sont appliquées lorsque la voie principale échoue.
Les budgets de délai d'attente varient selon le type de tâche (image/vidéo/OCR/vérification).
Les voies en streaming et non-streaming partagent la même enveloppe de réponse.
L'utilisation et les métadonnées sont normalisées indépendamment du fournisseur.

Exemple de requête

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

Contrat de réponse

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

Champs de sortie unifiés

success : indicateur d'état de l'opération.
content : texte récapitulatif/statut.
images/fichiers/vidéos : artefacts spécifiques à la modalité.
usage : charge utile de comptabilité normalisée.
metadata : diagnostics modèle/fournisseur/temporisation.

Modèles d'erreur

400

Charge utile invalide ou format de requête non pris en charge.

401

Authentification manquante ou invalide.

413

Charge utile d'entrée trop volumineuse.

415

Type de fichier/média non pris en charge.

422

Échec de validation dans le schéma ou les en-têtes de contexte.

429

Limite de taux dépassée.

503

Fournisseur indisponible, délai d'attente dépassé ou surcharge système.

Exemples

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