...
Eroare Aplicații AI cu LLM · JSON de la model

openai.BadRequestError: Error code: 400 - Missing required parameter: 'text.format.name'.

Pe scurt

La OpenAI Responses API, formatul json_schema din text.format are nevoie de un nume (name), pe lângă type și schema. Adaugă "name": "..." (litere, cifre, _ și -) în dicționarul format.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Responses API, ieșirea structurată se cere cu text={"format": {...}}. Pentru type: "json_schema", câmpurile obligatorii sunt name (un identificator al schemei) și schema (schema JSON propriu-zisă); strict: True e recomandat. Mesajul spune exact ce lipsește: text.format.name.

Eroarea apare des la mutarea codului din Chat Completions, unde aceeași informație stă în response_format={"type": "json_schema", "json_schema": {"name": ..., "schema": ...}}, cu un nivel în plus. În Responses API, name și schema stau direct în format. Dacă ai păstrat nivelul json_schema, numele nu e găsit.

Varianta Missing required parameter: 'text.format.schema'. are aceeași cauză, pentru schemă.

De ce apare: cauzele frecvente

1Format fără nume

Greșit
PYTHON
text={"format": {"type": "json_schema", "schema": SCHEMA}}
Corect
PYTHON
text={"format": {"type": "json_schema", "name": "contact", "schema": SCHEMA, "strict": True}}

Responses API cere name pentru orice schemă de tip json_schema.

2Structura din Chat Completions

Greșit
PYTHON
text={"format": {"type": "json_schema", "json_schema": {"name": "contact", "schema": SCHEMA}}}
Corect
PYTHON
text={"format": {"type": "json_schema", "name": "contact", "schema": SCHEMA}}

În Responses API nu mai există nivelul json_schema; name și schema stau direct în format.

Repară tu

Repară eroarea, direct în pagină

Programul cere de la OpenAI datele de contact în JSON, prin ieșire structurată, dar cererea e respinsă cu Missing required parameter: 'text.format.name'. Repară formatul: adaugă numele schemei (contact) și strict: True, apoi afișează Nume: <nume>, telefon: <telefon>.

Codul care dă eroarea
PYTHON
import json

from openai import OpenAI

MODEL = "gpt-6-luna"
client = OpenAI()
SCHEMA = {
    "type": "object",
    "properties": {"nume": {"type": "string"}, "telefon": {"type": "string"}},
    "required": ["nume", "telefon"],
    "additionalProperties": False,
}

r = client.responses.create(
    model=MODEL,
    input="Bună, sunt Elena Stan, mă găsiți la 0744 123 456.",
    text={"format": {"type": "json_schema", "schema": SCHEMA}},
)
date = json.loads(r.output_text)
print(f"Nume: {date['nume']}, telefon: {date['telefon']}")
După reparație, programul afișează
Nume: Elena Stan, telefon: 0744 123 456
Indiciu

{"type": "json_schema", "name": "contact", "schema": SCHEMA, "strict": True}

Alte forme ale mesajului

  • openai.BadRequestError: Error code: 400 - Missing required parameter: 'text.format.schema'.
  • openai.BadRequestError: Error code: 400 - {'error': {'message': "Missing required parameter: 'text.format.name'.", 'type': 'invalid_request_error', 'param': 'text.format.name', 'code': 'missing_required_parameter'}}

Cum o eviți pe viitor

  • Ține formatul ieșirii structurate într-o funcție ajutătoare, de exemplu format_json(nume, schema), folosită peste tot.
  • La migrarea din Chat Completions în Responses API, verifică pe rând parametrii care și-au schimbat forma: messages → input, response_format → text.format, max_tokens → max_output_tokens.
  • Folosește strict: True și additionalProperties: False.

Întrebări frecvente

Contează ce nume pun?

Numele identifică schema (apare în loguri și ajută modelul să înțeleagă ce generează). Folosește un nume descriptiv, cu litere, cifre, _ sau -.

Cum arată echivalentul la Claude?

La Claude, ieșirea structurată se cere cu output_config={"format": {"type": "json_schema", "schema": SCHEMA}}, fără nume.

Erori înrudite

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție

Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.