verboo code

Guia

Structured output

Solicite JSON previsível para integrar respostas diretamente ao seu código.

Nesta página

Use JSON Schema

cURL
curl https://code.verboo.ai/router/v1/chat/completions \
  -H "Authorization: Bearer $VERBOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "messages": [{"role": "user", "content": "Extract: Ana, ana@example.com"}],
    "response_format": {"type": "json_schema", "json_schema": {
      "name": "contact", "strict": true, "schema": {
        "type": "object",
        "properties": {"name": {"type": "string"}, "email": {"type": "string"}},
        "required": ["name", "email"], "additionalProperties": false
      }
    }}
  }'

Faça parse de message.content como JSON e valide novamente no seu backend antes de persistir ou executar ações.

Modos disponíveis

TipoComportamento
json_schemaRestringe a saída ao schema fornecido quando suportado.
json_objectSolicita JSON válido sem impor uma estrutura completa.

Disponibilidade por plano

Structured output pode exigir habilitação no plano. Se indisponível, a API retorna 403 com code structured_output_not_enabled.

Validação e fallback

  • Use schemas pequenos, explícitos e com additionalProperties: false.
  • Valide a saída no servidor mesmo com strict: true.
  • Trate recusa, truncamento e conteúdo vazio antes do parse.