openai.BadRequestError: Error code: 400 - Missing required parameter: 'text.format.name'.
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
text={"format": {"type": "json_schema", "schema": SCHEMA}}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
text={"format": {"type": "json_schema", "json_schema": {"name": "contact", "schema": SCHEMA}}}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ă 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>.
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']}")Nume: Elena Stan, telefon: 0744 123 456
Indiciu
{"type": "json_schema", "name": "contact", "schema": SCHEMA, "strict": True}
Reparația
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", "name": "contact", "schema": SCHEMA, "strict": True}},
)
date = json.loads(r.output_text)
print(f"Nume: {date['nume']}, telefon: {date['telefon']}")De ce merge
Responses API cere ca fiecare schemă de tip json_schema să aibă un nume, alături de schema propriu-zisă, altfel respinge cererea înainte să ajungă la model. Cu name și strict: True, modelul generează un JSON care respectă exact schema, iar json.loads(r.output_text) îl transformă în dicționar.
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șiadditionalProperties: 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
json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) `json.loads` a primit un text care nu începe cu JSON: modelul a pus JSON-ul între ```json ... ``` sau a scris o propoziție înainte. Cere ieșire structurată (`output_config` cu `json_schema` la Claude, `text.format` la OpenAI) sau scoate marcajele înainte de `json.loads`. AttributeError: 'str' object has no attribute 'get' Modelul întoarce mereu text, chiar și când textul arată ca JSON. Ai tratat textul ca pe un dicționar. Transformă-l întâi cu json.loads(text), apoi folosește .get() sau ["cheie"] pe dicționarul rezultat. AttributeError: module 'openai' has no attribute 'ChatCompletion' Codul folosește sintaxa veche `openai.ChatCompletion.create(...)`, care nu mai există din versiunea 1.0 a SDK-ului. Creează un client cu `client = OpenAI()` și apelează `client.chat.completions.create(...)` sau, mai nou, `client.responses.create(...)`. Î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.
