v—

Documentación de la API

Wrapper del AI SDK de Vercel con soporte para OpenRouter y Amazon Bedrock. Generación de texto, output estructurado, tools vía webhook, fallbacks de modelos y Fusion Router.

Autenticación

Depende del provider seleccionado.

POST /generate

Genera texto usando AI SDK con OpenRouter o Bedrock.

POST /generate

Alias: POST /api/generate, POST /api/chat

Headers

Body

Modelo y fallbacks

El campo model acepta un string o un array de strings. Con OpenRouter, un array activa fallbacks automáticos en orden de prioridad si el modelo anterior falla (rate limit, downtime, moderación, etc.).

Fallbacks

Fusion Router

Deliberación multi-modelo de OpenRouter Fusion. Un panel de modelos responde en paralelo, un juez compara las respuestas y tu modelo escribe la respuesta final.

¿Request normal o con Fusion?
  • Normal — no incluyas el campo fusion
  • Fusion disponible — incluye fusion: { ... } (aunque sea {})
  • Fusion forzada — agrega fusion.tool_choice: "required"

Roles

model Orquestador + juez (obligatorio)
fusion.analysis_models Panel que debate en paralelo (1–8, opcional)
fusion.judge_model Juez distinto al principal (opcional, avanzado)
fusion.tool_choice "required" — va dentro de fusion, no en config

Alias vs modelo propio

Alias openrouter/fusion
Modelo propio + fusion

Tools y webhooks

Define tools con tools + toolsWebhook. Cuando el modelo invoca una tool, tu servidor recibe un POST y debe devolver el resultado.

Request al webhook

Response del webhook

Tools async e interrupción

Redis (varias instancias)

Campos de control

Casos de uso

Prioridad del fallback al interrumpir

    Structured output

    Genera datos estructurados con el campo output.

    Objeto estructurado

    Respuesta de /generate

    Ejemplos

    simple

    Oros endpoints

    Spec JSON en GET /info · Health en GET /health

    ✓ Copiado