GET /api/qr/ai/providers

Devolve os provedores de LLM e os modelos que o endpoint de IA do marketplace (POST /api/qr/ai/generate) entende. Útil para interfaces de cliente que deixam o usuário escolher um provedor — não é preciso fixar a matriz no código; basta chamar este endpoint e exibir o que ele devolver.

O endpoint para consumidores (/api/qr/ai/generate/server) não precisa disso — o servidor escolhe o provedor por você.

Requisição

Resposta

{
  "success": true,
  "count": 10,
  "modelsNote": "Any model ID your provider offers works; this list shows recommended ones.",
  "providers": [
    {
      "id": "openai",
      "name": "OpenAI",
      "defaultModel": "gpt-6-luna",
      "availableModels": ["gpt-6-astra", "gpt-6.1-sol", "gpt-6-luna", "gpt-6-sol", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna", "gpt-4.1-mini"],
      "acceptsAnyModel": true
    },
    {
      "id": "anthropic",
      "name": "Anthropic",
      "defaultModel": "claude-sonnet-5-5",
      "availableModels": ["claude-fable-5-1", "claude-opus-5-5", "claude-sonnet-5-5", "claude-haiku-4-5"],
      "acceptsAnyModel": true
    },
    {
      "id": "google",
      "name": "Google Gemini",
      "defaultModel": "gemini-3.8-flash",
      "availableModels": ["gemini-3.1-pro-preview", "gemini-3.8-flash", "gemini-3.5-flash-lite", "gemini-3.5-flash"],
      "acceptsAnyModel": true
    },
    {
      "id": "mistral",
      "name": "Mistral AI",
      "defaultModel": "mistral-medium-latest",
      "availableModels": ["mistral-large-latest", "mistral-medium-latest", "mistral-small-latest"],
      "acceptsAnyModel": true
    },
    {
      "id": "cohere",
      "name": "Cohere",
      "defaultModel": "command-a-03-2025",
      "availableModels": ["command-a-plus-05-2026", "command-a-03-2025", "command-a-reasoning-08-2025", "command-r7b-12-2024"],
      "acceptsAnyModel": true
    },
    {
      "id": "groq",
      "name": "Groq",
      "defaultModel": "openai/gpt-oss-120b",
      "availableModels": ["openai/gpt-oss-120b", "openai/gpt-oss-20b", "llama-3.3-70b-versatile"],
      "acceptsAnyModel": true
    },
    {
      "id": "xai",
      "name": "xAI Grok",
      "defaultModel": "grok-4.3",
      "availableModels": ["grok-4.7", "grok-4.3", "grok-4.20-0309-non-reasoning"],
      "acceptsAnyModel": true
    },
    {
      "id": "deepseek",
      "name": "DeepSeek",
      "defaultModel": "deepseek-flash",
      "availableModels": ["deepseek-v4-pro", "deepseek-flash"],
      "acceptsAnyModel": true
    },
    {
      "id": "qwen",
      "name": "Alibaba Qwen",
      "defaultModel": "qwen3.8-flash",
      "availableModels": ["qwen3.8-max", "qwen3.7-plus", "qwen3.8-flash"],
      "acceptsAnyModel": true
    },
    {
      "id": "local",
      "name": "Local (Ollama / LM Studio)",
      "defaultModel": "",
      "availableModels": [],
      "acceptsAnyModel": true
    }
  ]
}

Como escolher um modelo

Se você não passar llmModel, o motor usa o modelo padrão do provedor listado abaixo. Passe llmModel: "<id>" na chamada de geração para escolher outro.

Qualquer ID de modelo oferecido pelo seu provedor funciona; esta lista mostra os recomendados.

Você paga os tokens de cada geração diretamente ao seu provedor, pelos preços vigentes dele; não adicionamos nenhuma taxa. Consulte a página de preços de cada provedor para saber o custo exato.

Erros

Veja Erros para a matriz completa de códigos.