AI API / deep divesInformational

Structured output API: JSON mode și schema

Folosește response_format json_object și JSON Schema pentru a obtine output structurat valid.

Raspuns scurt

Pentru output JSON valid, folosește response_format json_object și include schema in prompt; pentru garantii puternice, modelul accepta JSON Schema in unele variante.

Problema concreta

Pipelines de date au nevoie de output JSON valid de la model. Modelele care 'aproape' returneaza JSON crapa pipeline-urile la productie.

Cum o rezolva Router by MP

Setezi response_format json_object și descrii schema in prompt cu exemple. Pentru schema validation, folosesti tool calling cu o funcție 'parser' care primeste JSON-ul.

Fluxuri uzuale

Prompt cu descriere schema + exemple.
response_format json_object.
Validare JSON Schema in cod după raspuns.
Fallback la retry cu prompt corectat.

Modele recomandate

gpt-5.4-mini
gpt-5.4-pro

Disponibilitatea reala se verifica live in /models.

Control	De ce conteaza
JSON garantat	json_object impiedica raspunsuri text plain.
Schema in prompt	Exemple cu schema cresc rata de validitate.
Validare codului	Aplicatia ramane responsabila de schema validation.

TypeScript JSON modets

const res = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  response_format: { type: "json_object" },
  messages: [
    { role: "system", content: "Returneaza un JSON cu { name, email, score }." },
    { role: "user", content: leadDescriere },
  ],
});
const data = JSON.parse(res.choices[0].message.content!);

Reguli si limite

Suport partial. JSON Schema strict nu este disponibil la toate modelele; verifica /models.
Cost. JSON valid crește tokenii output; folosește schema mica.
Retry. Pregateste retry pentru cazuri rare când JSON ramane invalid.

Integrare rapida

Foloseste endpointul https://api.megapromoting.com/v1, trimite cheia caAuthorization: Bearer <router_api_key> si verifica pagina/modelsinainte de productie.

Mai departe