Structured Outputs

Cuando incluyes response_format en el body de tu request, el modelo garantiza que la respuesta cumple el esquema JSON que enviaste. Útil para parsing determinista sin retries. Si el modelo seleccionado no soporta esta capacidad, Geek Hub rechaza la request antes de salir del gateway y te devuelve la lista de modelos compatibles.

Ejemplo: extracción de factura

curl -X POST https://api.geekhub.mx/v1/chat/completions \
  -H "Authorization: Bearer ghub_sk_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-mini",
    "messages": [
      {"role":"system","content":"Eres un asistente que extrae datos de facturas."},
      {"role":"user","content":"Factura #A123 de Geek Vibes por $12,345.67 MXN del 12 de junio de 2026."}
    ],
    "response_format": {
      "type": "json_schema",
      "json_schema": {
        "name": "factura",
        "strict": true,
        "schema": {
          "type": "object",
          "properties": {
            "folio": { "type": "string" },
            "emisor": { "type": "string" },
            "total_mxn": { "type": "number" },
            "fecha_iso": { "type": "string", "format": "date" }
          },
          "required": ["folio", "emisor", "total_mxn", "fecha_iso"],
          "additionalProperties": false
        }
      }
    }
  }'

El campo content viene como string JSON parseable. Tu app hace JSON.parse(content) y obtiene el objeto tipado directamente.

Modo simple

Si solo necesitas un objeto JSON válido sin schema fijo:

"response_format": { "type": "json_object" }

OpenAI requiere que tu prompt incluya la palabra “json” cuando usas json_object. No es un requisito de Geek Hub sino del proveedor.

Modelos compatibles

12 de 28 modelos chat soportan structured outputs.

Familia	Modelos
Anthropic	claude-opus-4-8, claude-sonnet-4-6, claude-haiku-4-5
Google	gemini-2.5-pro, gemini-2.5-flash
OpenAI	gpt-5, gpt-4.1, gpt-4.1-mini, o4-mini
xAI	grok-4, grok-3, grok-3-mini

Rechazo

HTTP/1.1 422 Unprocessable Entity

{
  "error": {
    "type": "structured_outputs_not_supported",
    "message": "El modelo \"deepseek/deepseek-v4-flash\" no soporta structured outputs.",
    "model": "deepseek/deepseek-v4-flash",
    "compatible_models": [
      "anthropic/claude-opus-4-8",
      "openai/gpt-5.4-mini",
      "..."
    ]
  }
}

Combinable con Model Fallbacks: si pasas una lista de candidatos, los que no soporten structured outputs se saltan en vez de fallar.

Empezar

Conceptos

Features avanzadas

Legal & cumplimiento

Structured Outputs

Ejemplo: extracción de factura

Modo simple

Modelos compatibles

Rechazo

​Ejemplo: extracción de factura

​Modo simple

​Modelos compatibles

​Rechazo

Ejemplo: extracción de factura

Modo simple

Modelos compatibles

Rechazo