OpenQCoreAI
Filloni

Burimet · Iris API

Dokumentacioni i Iris API

Referencë multimodale me cilësi ndërmarrjeje për gjenerimin e imazheve, rrjedhat e video, OCR, rrugët e verifikimit, rregullat e rutimit dhe kontratat e daljes të unifikuara.

Kthehu te DokumentetShko te Katalogu i Modeleve

Katalogu i Modeleve

iris-orbit

Rejim i rutimit automatik në korsitë multimodale.

iris-genesis

Modeli kryesor për gjenerimin e imazheve.

iris-edit

Rruga e redaktimit të imazheve (disponueshmëria varet nga koha e ekzekutimit).

iris-lens

Analizë e imazhit dhe interpretim vizual.

iris-video

Rrjedha e punës për gjenerimin e videove.

iris-ocr

Përpunim për nxjerrjen OCR të dokumenteve.

iris-verify

Rrjedha e verifikimit të identitetit.

iris-guard

Rruga për zbulimin e mashtrimit (varet nga koha e ekzekutimit).

iris-face

Rruga e verifikimit të fytyrës (varet nga koha e ekzekutimit).

Pikat e përfundimit

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

Logjika e Rutimit

  • Qëllimi i promptit përcakton kanalin për imazh, video, OCR ose verifikim.
  • Aplikohen zinxhirë rezervë të ofruesve kur rruga kryesore dështon.
  • Buxhetet e kohëskajës ndryshojnë sipas llojit të detyrës (imazh/video/OCR/verifikim).
  • Rrugët streaming dhe jo-streaming ndajnë të njëjtin format përgjigjeje.
  • Përdorimi dhe metadata normalizohen pavarësisht nga ofruesi.

Shembull i Kërkesës

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

Kontrata e Përgjigjes

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

Fushat e Daljes së Unifikuara

  • sukses: tregues i statusit të operacionit.
  • përmbajtje: tekst përmbledhjeje/statusi.
  • imazhe/skedarë/video: artefakte specifike për modalitetin.
  • përdorim: të dhëna të normalizuara të shfrytëzimit.
  • metadata: diagnostikë për modelin, ofruesin dhe kohën.

Modelet e Gabimeve

400

Ngarkesë e pavlefshme ose format i kërkesës i papërkrahur.

401

Autentikim i munguar ose i pavlefshëm.

413

Ngarkesa e hyrjes tepër e madhe.

415

Lloj skedari/mediash i papërkrahur.

422

Dështim i validimit në skemë ose në kokat e kontekstit.

429

Kufiri i kërkesave u tejkalua.

503

Ofruesi i padisponueshëm, skadim kohe, ose ngarkesë e tepërt e sistemit.

Shembuj

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