OpenQCoreAI
ابدأ الآن

الموارد · Iris API

توثيق Iris API

مرجع متعدد الوسائط بمستوى مؤسسي لتوليد الصور ومسارات الفيديو و OCR والتحقق، مع منطق التوجيه وعقد مخرجات موحد.

الرجوع للتوثيقاذهب إلى كتالوج النماذج

كتالوج النماذج

iris-orbit

وضع توجيه تلقائي عبر مسارات الوسائط المختلفة.

iris-genesis

النموذج الأساسي لتوليد الصور.

iris-edit

مسار تعديل الصور (حسب توفره في بيئة التشغيل).

iris-lens

تحليل الصور والتفسير البصري.

iris-video

مسار توليد الفيديو.

iris-ocr

مسار استخراج النص من المستندات OCR.

iris-verify

مسار التحقق من الهوية.

iris-guard

مسار كشف الاحتيال (يعتمد على بيئة التشغيل).

iris-face

مسار التحقق الحيوي للوجه (يعتمد على بيئة التشغيل).

نقاط النهاية

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

منطق التوجيه

  • نية الطلب تحدد مسار صورة أو فيديو أو OCR أو تحقق.
  • تُطبق سلاسل fallback للمزودين عند فشل المسار الأساسي.
  • ميزانيات الوقت تختلف حسب نوع المهمة (صورة/فيديو/OCR/تحقق).
  • المسار المتدفق وغير المتدفق يشتركان في نفس Envelope للاستجابة.
  • الاستهلاك والبيانات الوصفية يتم توحيدها بغض النظر عن المزود.

مثال الطلب

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

عقد الاستجابة

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

حقول المخرجات الموحدة

  • success: مؤشر حالة العملية.
  • content: نص ملخص/حالة التنفيذ.
  • images/files/videos: مخرجات خاصة بكل وسيط.
  • usage: حمولة استهلاك موحدة.
  • metadata: تشخيصات النموذج/المزود/الزمن.

نماذج الأخطاء

400

طلب غير صالح أو بنية غير مدعومة.

401

مصادقة مفقودة أو غير صحيحة.

413

حجم الإدخال أكبر من المسموح.

415

نوع ملف/وسائط غير مدعوم.

422

فشل التحقق في المخطط أو هيدرز السياق.

429

تم تجاوز حد المعدل.

503

المزود غير متاح، أو انتهت المهلة، أو يوجد ضغط نظام.

أمثلة

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