Saltar al contenido

GET /api/qr/ai/providers

Devuelve los proveedores y modelos de LLM que entiende el endpoint de IA de Marketplace (POST /api/qr/ai/generate). Es útil en interfaces de cliente que dejan elegir proveedor: no hace falta fijar la matriz en el código; llama a este endpoint y muestra lo que devuelva.

El endpoint para consumidores (/api/qr/ai/generate/server) no lo necesita: el servidor elige el proveedor por ti.

Petición

Respuesta

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

Cómo elegir modelo

Si no pasas llmModel, el motor usa el modelo por defecto del proveedor que aparece abajo. Pasa llmModel: "<id>" en la llamada de generación para elegir otro.

Funciona cualquier ID de modelo que ofrezca tu proveedor; esta lista muestra los recomendados.

ProveedorModelo por defecto
OpenAIgpt-6-luna
Anthropicclaude-sonnet-5-5
Googlegemini-3.8-flash
Mistralmistral-medium-latest
Coherecommand-a-03-2025
Groqopenai/gpt-oss-120b
xAIgrok-4.3
DeepSeekdeepseek-flash
Qwenqwen3.8-flash
Local ("local")el modelo que sirva tu endpoint

Los tokens de cada generación los pagas directamente a tu proveedor, a sus precios vigentes; no añadimos ningún recargo. Consulta la página de precios de cada proveedor para saber el coste exacto.

Errores

CódigoSignificado
INVALID_LLM_PROVIDERllmProvider no es ninguno de los ids anteriores.
INVALID_LLM_MODELllmModel no tiene formato de ID de modelo (letras, dígitos, . _ : / -, hasta 100 caracteres).
LLM_API_KEY_INVALIDEl proveedor ha rechazado la clave que enviaste.

Consulta Errores para ver la matriz completa de códigos.