OpenQCoreAI
Başlayın

Kaynaklar · Iris API

Iris API Belgeleri

Görüntü üretimi, video akışları, OCR, doğrulama yolları, yönlendirme kuralları ve birleşik çıktı sözleşmeleri için kurumsal düzeyde çok modlu referans.

Belgelere geri dönModel Kataloğuna atla

Model Kataloğu

iris-orbit

Çok modlu kanallar arasında otomatik yönlendirme modu.

iris-genesis

Birincil görüntü oluşturma modeli.

iris-edit

Görüntü düzenleme akışı (kullanılabilirlik çalışma zamanına bağlıdır).

iris-lens

Görüntü analizi ve görsel yorumlama.

iris-video

Video oluşturma akışı.

iris-ocr

Belge OCR çıkarım hattı.

iris-verify

Kimlik doğrulama akışı.

iris-guard

Sahtekarlık tespit akışı (çalışma zamanına bağlı).

iris-face

Yüz doğrulama akışı (çalışma zamanına bağlı).

Uç Noktalar

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

Yönlendirme Mantığı

  • Girilen prompt'un amacı, görüntü, video, OCR veya doğrulama hattını belirler.
  • Birincil yol başarısız olduğunda sağlayıcı yedekleme zincirleri devreye girer.
  • Zaman aşımı bütçeleri görev türüne göre değişir (görüntü/video/OCR/doğrulama).
  • Akışlı ve akışsız yollar aynı yanıt yapısını kullanır.
  • Kullanım ve meta veriler sağlayıcıya bakılmaksızın normalleştirilir.

İstek Örneği

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

Yanıt Sözleşmesi

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

Birleşik Çıktı Alanları

  • success: işlem durum bayrağı.
  • content: özet/durum metni.
  • images/files/videos: modaliteye özgü çıktılar.
  • usage: normalleştirilmiş kullanım verisi.
  • metadata: model/sağlayıcı/zamanlama tanılama bilgileri.

Hata Modelleri

400

Geçersiz içerik veya desteklenmeyen istek biçimi.

401

Kimlik doğrulama eksik veya geçersiz.

413

İstek yükü çok büyük.

415

Desteklenmeyen dosya veya medya türü.

422

Şema veya bağlam başlıklarında doğrulama hatası.

429

İstek limiti aşıldı.

503

Sağlayıcı kullanılamıyor, zaman aşımı oluştu veya sistem aşırı yüklü.

Örnekler

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