OpenQCoreAI
Começar

Recursos · Iris API

Documentação da Iris API

Referência multimodal de nível empresarial para geração de imagens, fluxos de vídeo, OCR, caminhos de verificação, regras de roteamento e contratos de saída unificados.

Voltar à documentaçãoIr para o Catálogo de Modelos

Catálogo de Modelos

iris-orbit

Modo de roteamento automático entre canais multimodais.

iris-genesis

Modelo principal de geração de imagens.

iris-edit

Rota de edição de imagens (disponibilidade depende do tempo de execução).

iris-lens

Análise de imagens e interpretação visual.

iris-video

Fluxo de geração de vídeo.

iris-ocr

Pipeline de extração OCR de documentos.

iris-verify

Fluxo de verificação de identidade.

iris-guard

Rota de deteção de fraude (dependente do tempo de execução).

iris-face

Rota de verificação facial (dependente do tempo de execução).

Endpoints

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

Lógica de Roteamento

  • A intenção do prompt determina a rota: imagem, vídeo, OCR ou verificação.
  • Cadeias de fallback de provedores são aplicadas se o caminho primário falhar.
  • Os limites de tempo variam conforme o tipo de tarefa (imagem/vídeo/OCR/verificação).
  • Os caminhos com e sem streaming usam o mesmo envelope de resposta.
  • Uso e metadados são normalizados independentemente do provedor.

Exemplo de Requisição

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

Contrato de Resposta

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

Campos de Saída Unificados

  • success: indicador de estado da operação.
  • content: texto de resumo/estado.
  • images/files/videos: artefatos específicos por modalidade.
  • usage: payload de contabilização normalizado.
  • metadata: diagnósticos de modelo/provedor/tempo.

Modelos de Erro

400

Payload inválido ou formato de requisição não suportado.

401

Autenticação ausente ou inválida.

413

Carga útil de entrada muito grande.

415

Tipo de arquivo/mídia não suportado.

422

Falha de validação no schema ou nos cabeçalhos de contexto.

429

Limite de requisições excedido.

503

Provedor indisponível, timeout ou sobrecarga do sistema.

Exemplos

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