TypeError: create() got an unexpected keyword argument 'temperature'
Versiunea actuală a API-ului Claude nu mai acceptă `temperature` (nici `top_p`, `top_k`), așa că SDK-ul respinge argumentul. Scoate-l din apel; tonul și consecvența le controlezi prin system prompt, iar cât „gândește” modelul prin `output_config={"effort": "low"}`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
got an unexpected keyword argument e mesajul standard Python când dai unei funcții un parametru pe care nu îl are. Aici funcția e messages.create, iar parametrul e temperature. În API-ul Claude actual (versiunea folosită în curs), parametrii de eșantionare temperature, top_p și top_k au fost scoși: SDK-ul îi respinge cu TypeError, iar un apel HTTP direct primește 400.
Eroarea apare când copiezi cod din tutoriale mai vechi, unde temperature=0 era rețeta pentru răspunsuri „deterministe”. Modelele de raționament ale OpenAI resping și ele temperature, cu un mesaj de forma Unsupported parameter: 'temperature' is not supported with this model.
Aceeași eroare, cu alt nume, apare pentru orice parametru inexistent: o greșeală de scriere (max_token=, system_prompt=) dă unexpected keyword argument 'max_token'. Citește numele dintre ghilimele: îți spune exact ce argument să scoți sau să corectezi.
De ce apare: cauzele frecvente
1temperature copiat dintr-un tutorial vechi
r = client.messages.create(model=MODEL, max_tokens=300, temperature=0,
messages=mesaje)r = client.messages.create(model=MODEL, max_tokens=300,
system="Răspunzi sobru, în maximum 3 propoziții, mereu în aceeași structură.",
output_config={"effort": "low"},
messages=mesaje)Parametrul nu mai există, deci apelul cade. Consecvența răspunsului o obții prin instrucțiuni clare și un format fix.
2Nume de parametru scris greșit
r = client.messages.create(model=MODEL, max_token=300, messages=mesaje)r = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)max_token (fără „s”) nu e un parametru al funcției, deci Python îl respinge cu același tip de eroare.
3System prompt dat cu alt nume
r = client.messages.create(model=MODEL, max_tokens=300, system_prompt=SYSTEM, messages=mesaje)r = client.messages.create(model=MODEL, max_tokens=300, system=SYSTEM, messages=mesaje)La Claude, instrucțiunile generale se trimit în parametrul system. system_prompt nu există.
Repară eroarea, direct în pagină
Codul de mai jos dă TypeError: create() got an unexpected keyword argument 'temperature'. Scoate parametrul respins și obține un ton sobru printr-un system prompt (constanta SYSTEM există deja, trimite-o cu system=). Programul afișează textul răspunsului.
import anthropic
MODEL = "claude-haiku-5-5"
SYSTEM = "Ești asistentul unei clinici stomatologice. Răspunzi sobru, în două propoziții, fără exclamații."
client = anthropic.Anthropic()
raspuns = client.messages.create(
model=MODEL,
max_tokens=200,
temperature=0,
messages=[{"role": "user", "content": "Pot reprograma consultația de mâine?"}],
)
print(raspuns.content[0].text)Da, puteți reprograma consultația cu cel puțin 24 de ore înainte. Vă rugăm să ne spuneți ziua și intervalul preferat.
Indiciu
Parametrul temperature nu mai există; tonul îl dă system=SYSTEM.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
SYSTEM = "Ești asistentul unei clinici stomatologice. Răspunzi sobru, în două propoziții, fără exclamații."
client = anthropic.Anthropic()
raspuns = client.messages.create(
model=MODEL,
max_tokens=200,
system=SYSTEM,
messages=[{"role": "user", "content": "Pot reprograma consultația de mâine?"}],
)
print(raspuns.content[0].text)De ce merge
API-ul Claude actual nu mai are parametri de eșantionare, deci temperature oprește apelul încă din SDK. Ce voiai de fapt, un răspuns sobru și consecvent, vine din instrucțiuni: system prompt-ul descrie tonul și structura, iar modelul le respectă la fiecare apel. Fără parametrul respins, cererea pleacă și primești răspunsul.
Alte forme ale mesajului
TypeError: Messages.create() got an unexpected keyword argument 'temperature'TypeError: create() got an unexpected keyword argument 'top_p'openai.BadRequestError: Error code: 400 - Unsupported parameter: 'temperature' is not supported with this model.
Cum o eviți pe viitor
- Când copiezi cod pentru un API de AI, verifică parametrii în documentația actuală: API-urile se schimbă des.
- Controlează stilul prin system prompt (ton, lungime, structură) și prin exemple, nu prin parametri de eșantionare.
- Ține apelul într-o singură funcție a proiectului; dacă un parametru dispare, îl scoți dintr-un singur loc.
Întrebări frecvente
Cum obțin atunci răspunsuri mai previzibile?
Prin instrucțiuni: spune exact formatul, lungimea și tonul, dă un exemplu, iar pentru date folosește ieșire JSON cu schemă (output_config cu format). Un format fix face răspunsurile mult mai consecvente decât orice temperature.
La OpenAI pot folosi temperature?
Doar la modelele care îl acceptă. Modelele de raționament îl resping cu 400 (Unsupported parameter: 'temperature'). În cursul nostru, modelele OpenAI din simulator se comportă la fel.
Erori înrudite
TypeError: Missing required arguments; Expected either ('max_tokens', 'messages' and 'model') or ('max_tokens', 'messages', 'model' and 'stream') arguments to be given Apelul `client.messages.create(...)` nu are unul dintre parametrii obligatorii, de cele mai multe ori `max_tokens`. La API-ul Claude, `model`, `max_tokens` și `messages` sunt obligatorii: adaugă `max_tokens=500` (sau cât îți trebuie) în apel. messages: Unexpected role "system". The Messages API accepts a top-level `system` parameter, not "system" as an input message role. Ai pus instrucțiunile ca mesaj cu `"role": "system"` în lista `messages`, ca la OpenAI. La API-ul Claude, lista conține doar roluri `user` și `assistant`; system prompt-ul se trimite separat, în parametrul `system=`. anthropic.NotFoundError: Error code: 404 - {'type': 'error', 'error': {'type': 'not_found_error', 'message': 'model: claude-haiku-5.5'}} API-ul nu cunoaște modelul cerut: numele e scris greșit (puncte în loc de cratime, versiune inexistentă) sau modelul a fost retras. Copiază id-ul exact din documentație sau din `client.models.list()`, de exemplu `claude-haiku-5-5`, și ține-l într-o constantă `MODEL`. Î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.
