...
Eroare Aplicații AI cu LLM · Parametri și mesaje respinse de API

openai.BadRequestError: Error code: 400 - Invalid value: 'model'. Supported values are: 'assistant', 'system', 'developer', and 'user'.

Pe scurt

Un mesaj din input are un rol pe care OpenAI nu îl acceptă (aici 'model', rolul folosit de Gemini). Rolurile valide sunt user, assistant, system și developer. Convertește rolurile când muți istoricul de la alt furnizor: 'model' sau 'bot' devin 'assistant'.

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

Ce înseamnă

Fiecare mesaj din input (Responses API) sau din messages (Chat Completions) are un câmp role. API-ul acceptă doar o listă fixă de valori, iar mesajul îți spune și valoarea primită ('model'), și pe cele permise.

Cazul tipic este istoricul venit din altă parte: conversații salvate de o bibliotecă sau de alt furnizor (Gemini folosește model pentru răspunsurile asistentului), un export dintr-un CRM cu roluri bot / client, sau un tool result trimis cu role: "tool" în Responses API, unde rezultatele merg ca item-uri function_call_output.

Caută în cod sau în datele salvate valoarea din mesaj și normalizează rolurile într-un singur loc, înainte de apel.

De ce apare: cauzele frecvente

1Istoric preluat de la alt furnizor

Greșit
PYTHON
istoric = [{"role": "user", "content": "..."}, {"role": "model", "content": "..."}]
client.responses.create(model=MODEL, input=istoric)
Corect
PYTHON
ROLURI = {"model": "assistant", "bot": "assistant"}
intrari = [{**m, "role": ROLURI.get(m["role"], m["role"])} for m in istoric]
client.responses.create(model=MODEL, input=intrari)

Fiecare API are vocabularul lui de roluri. O conversie la margine te lasă să păstrezi datele vechi neschimbate.

2Rezultatul unui tool trimis cu rolul tool în Responses API

Greșit
PYTHON
intrari.append({"role": "tool", "content": rezultat})
Corect
PYTHON
intrari.append({"type": "function_call_output", "call_id": apel.call_id, "output": rezultat})

Rolul tool există doar în Chat Completions. În Responses API, rezultatul unui tool e un item separat, legat prin call_id.

Repară tu

Repară eroarea, direct în pagină

Istoricul conversației a fost salvat de vechiul chatbot, care folosea rolul model pentru răspunsurile asistentului. Trimis la OpenAI, dă Invalid value: 'model'. Repară programul: înainte de apel, convertește rolurile cu un dicționar ROLURI = {"model": "assistant"} (celelalte rămân la fel) și afișează răspunsul.

Codul care dă eroarea
PYTHON
from openai import OpenAI

MODEL = "gpt-6-luna"
client = OpenAI()

istoric = [  # salvat de vechiul chatbot
    {"role": "user", "content": "Ce garanție are laptopul?"},
    {"role": "model", "content": "Laptopul are garanție 24 de luni."},
    {"role": "user", "content": "Și bateria?"},
]

r = client.responses.create(model=MODEL, input=istoric)
print(r.output_text)
După reparație, programul afișează
Bateria are o garanție separată, de 12 luni.
Indiciu

{**m, "role": ROLURI.get(m["role"], m["role"])} pentru fiecare mesaj.

Alte forme ale mesajului

  • openai.BadRequestError: Error code: 400 - {'error': {'message': "Invalid value: 'model'. Supported values are: 'assistant', 'system', 'developer', and 'user'.", 'type': 'invalid_request_error', 'param': 'input[1]', 'code': 'invalid_value'}}
  • openai.BadRequestError: Error code: 400 - Invalid value: 'tool'. Supported values are: 'assistant', 'system', 'developer', and 'user'.

Cum o eviți pe viitor

  • Păstrează istoricul aplicației într-un format propriu (de exemplu autor: client/asistent) și convertește-l la formatul fiecărui furnizor într-o singură funcție.
  • Validează rolurile înainte de apel: assert m["role"] in {"user", "assistant", "system", "developer"}.
  • La tool-uri, folosește formatul de rezultat al API-ului pe care îl apelezi.

Întrebări frecvente

Care e diferența dintre system și developer?

Ambele dau instrucțiuni modelului. developer e rolul recomandat de OpenAI pentru instrucțiunile aplicației la modelele noi; în Responses API poți folosi și parametrul instructions.

Claude acceptă rolul model?

Nu. API-ul Claude acceptă în messages doar user și assistant, iar instrucțiunile merg în parametrul system.

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.