Erori Aplicații AI cu LLM explicate: ce înseamnă și cum le repari
Mesajele de eroare Aplicații AI cu LLM pe care le primești cel mai des, fiecare explicat pe înțeles: ce înseamnă, de ce apare, cod greșit lângă cod corect și cum o repari. Înveți de la zero cu Curs Aplicații AI cu Claude și OpenAI: primele 8 lecții sunt gratuite.
Pagină coordonată de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
- 110erori
- 10capitole
- 66ușor
- 43mediu
- 1greu
Aici găsești erorile pe care le primești când construiești aplicații cu modele de limbaj prin API, în Python, cu SDK-urile anthropic și openai: chei invalide și cont fără credit, parametri respinși, mesaje în ordinea greșită, răspunsuri citite cu structura altui furnizor, JSON invalid sau tăiat de la model, tool use cu rezultate lipsă, rate limit, suprasolicitare, timeout, context prea lung și vectori de embeddings care nu se potrivesc. Fiecare eroare e explicată pe înțeles: ce spune mesajul, de ce apare, cu codul greșit lângă cel corect, cum o repari și cum o eviți în producție.
Erorile sunt grupate pe capitole, de la instalare și chei până la RAG, iar în fiecare capitol cele mai întâlnite sunt primele. Caută mesajul exact din consolă, citește cauzele și alege-o pe cea care se potrivește cu codul tău. La „Repară tu”, ai în editor un program care produce eroarea: îl repari și îl rulezi direct în pagină, pe un simulator al API-urilor cu aceeași interfață ca bibliotecile reale, fără cheie API și fără cost.
Instalare, import, chei API și facturare
ModuleNotFoundError: No module named 'anthropic' Python nu găsește pachetul `anthropic` (sau `openai`) în mediul în care rulezi programul. Instalează-l cu `pip install anthropic` în același mediu (venv) cu care rulezi scriptul și verifică dacă numele din `import` e scris corect. Explicația completă → Ușor Repară tu 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(...)`. Explicația completă → Ușor Repară tu anthropic.AuthenticationError: Error code: 401 - {'type': 'error', 'error': {'type': 'authentication_error', 'message': 'invalid x-api-key'}} API-ul Claude a respins cheia trimisă: e greșită, expirată, ștearsă sau e o cheie de la alt furnizor. Pune o cheie validă de la Anthropic (începe cu `sk-ant-`) în variabila de mediu `ANTHROPIC_API_KEY` și creează clientul fără `api_key=` în cod. Explicația completă → Ușor Repară tu openai.AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-proj-****abcd. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_api_key'}} OpenAI a respins cheia API: e scrisă greșit, a fost ștearsă, e o valoare de exemplu („cheia-ta-aici”) sau e cheia altui furnizor. Creează o cheie nouă în platforma OpenAI, pune-o în variabila de mediu `OPENAI_API_KEY` și creează clientul cu `OpenAI()`, fără cheie în cod. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - Your credit balance is too low to access the Anthropic API. Please go to Plans & Billing to upgrade or purchase credits. Contul Anthropic al cheii nu mai are credit, așa că API-ul refuză orice cerere. Adaugă credit (sau activează reîncărcarea automată) din Plans & Billing în consola Anthropic; în cod, prinde eroarea și arată utilizatorului un mesaj prietenos, fără să reîncerci. Explicația completă → Mediu Repară tu openai.RateLimitError: Error code: 429 - You exceeded your current quota, please check your plan and billing details. Contul OpenAI nu mai are credit sau a atins limita lunară de cheltuieli (`insufficient_quota`), deși eroarea vine ca 429. Adaugă credit sau mărește limita din Billing; în cod, nu o reîncerca la nesfârșit ca pe un rate limit obișnuit, ci arată un mesaj și alertează-te. Explicația completă → Ușor Repară tu KeyError: 'ANTHROPIC_API_KEY' Codul citește cheia cu os.environ["ANTHROPIC_API_KEY"], dar variabila de mediu nu există în procesul în care rulează programul. Setează variabila (sau încarcă fișierul .env cu load_dotenv() înainte de citire) și folosește os.environ.get(...) cu un mesaj clar când lipsește. Explicația completă → Ușor Repară tu AttributeError: module 'openai' has no attribute 'error' Codul prinde excepțiile cu openai.error.RateLimitError, ca în SDK-ul vechi (0.x). În openai 1.0 și mai nou, modulul openai.error nu mai există: excepțiile sunt direct în pachet, de exemplu except openai.RateLimitError sau except openai.APIError. Explicația completă → Mediu Repară tu anthropic.PermissionDeniedError: Error code: 403 - {'type': 'error', 'error': {'type': 'permission_error', 'message': 'Your API key does not have permission to use the specified resource.'}} Cheia API e validă (altfel ai primi 401), dar nu are voie să folosească resursa cerută: modelul, funcția sau workspace-ul. Verifică în consolă workspace-ul și permisiunile cheii sau folosește o cheie cu acces; în cod, tratează 403 separat și nu-l reîncerca. Explicația completă → Ușor Repară tu ModuleNotFoundError: No module named 'dotenv' Pachetul care oferă load_dotenv() nu e instalat în mediul Python în care rulezi programul. Instalează-l cu pip install python-dotenv (pachetul se numește python-dotenv, nu dotenv), în același mediu virtual în care rulezi codul. Explicația completă → Ușor Repară tu TypeError: 'module' object is not callable Ai apelat cu paranteze modulul importat (anthropic() sau openai()), nu clasa clientului din el. Creează clientul cu anthropic.Anthropic() sau, după from openai import OpenAI, cu OpenAI(). Explicația completă → Ușor Repară tu AttributeError: type object 'Anthropic' has no attribute 'messages' Ai folosit clasa Anthropic în loc de un client creat din ea: lipsesc parantezele de la anthropic.Anthropic(). Scrie client = anthropic.Anthropic() și apoi client.messages.create(...). Explicația completă → Ușor Repară tu AttributeError: 'Anthropic' object has no attribute 'chat' Ai folosit pe clientul Claude sintaxa OpenAI (client.chat.completions.create). Clientul anthropic.Anthropic() trimite mesaje cu client.messages.create(model=..., max_tokens=..., messages=[...]), iar răspunsul se citește din r.content[0].text. Explicația completă → Ușor Repară tu ImportError: cannot import name 'OpenAI' from 'openai' Modulul openai există, dar nu conține numele importat: ai o versiune veche (sub 1.0, fără clasa OpenAI), ai scris greșit numele sau un fișier al tău numit openai.py ascunde biblioteca. Actualizează cu pip install -U openai și verifică numele fișierelor. Explicația completă → Parametri și mesaje respinse de API
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. Explicația completă → Ușor Repară tu 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"}`. Explicația completă → Ușor Repară tu 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`. Explicația completă → Ușor Repară tu 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=`. Explicația completă → Mediu Repară tu anthropic.BadRequestError: Error code: 400 - messages: first message must use the "user" role Lista `messages` începe cu un mesaj `assistant`, iar API-ul Claude cere ca primul mesaj să fie de la `user`. Apare des după ce tai istoricul conversației și rămâne în față un răspuns al asistentului: taie în perechi sau scoate mesajele `assistant` de la început. Explicația completă → Mediu Repară tu anthropic.BadRequestError: Error code: 400 - This model does not support assistant message prefill. The conversation must end with a user message. Ultimul mesaj din `messages` e de la `assistant` (tehnica „prefill”, folosită ca să forțezi începutul răspunsului, de exemplu `{`), iar modelele Claude actuale nu o mai acceptă. Conversația trebuie să se termine cu un mesaj `user`; pentru JSON garantat folosește `output_config` cu `format` de tip `json_schema`. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - messages: at least one message is required Ai trimis cererea cu lista messages goală. API-ul are nevoie de cel puțin un mesaj user. De obicei mesajul utilizatorului e adăugat în istoric după apel în loc de înainte, sau istoricul a fost golit ori tăiat complet. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - messages.2: all messages must have non-empty content except for the optional final assistant message Unul dintre mesajele trimise are conținut gol ("" sau listă goală). Numărul din messages.2 îți spune poziția lui în listă. Nu adăuga în istoric mesaje goale: verifică textul utilizatorului după strip() și răspunsurile asistentului înainte să le salvezi. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - max_tokens: Input should be greater than or equal to 1 Ai trimis max_tokens cu valoarea 0 sau negativă. De obicei valoarea e calculată (buget rămas, limită minus tokeni folosiți) și a ajuns la zero. Verifică rezultatul înainte de apel: dacă bugetul e consumat, nu mai trimite cererea și spune asta utilizatorului. Explicația completă → Ușor Repară tu openai.BadRequestError: Error code: 400 - Invalid value: 'model'. Supported values are: 'assistant', 'system', 'developer', and 'user'. 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'. Explicația completă → Ușor Repară tu openai.BadRequestError: Error code: 400 - Invalid type for 'input[0]': expected an object, but got a string instead. La OpenAI Responses API, input poate fi un singur text sau o listă de mesaje (dicționare cu role și content), dar nu o listă de texte. Transformă fiecare text într-un mesaj: {"role": "user", "content": text}, sau trimite direct un singur șir. Explicația completă → Ușor Repară tu TypeError: Messages.create() takes 1 positional argument but 2 were given Metodele SDK-ului primesc doar argumente cu nume (model=..., messages=...), iar tu ai dat o valoare pe poziție, de obicei un dicționar cu toți parametrii. Despachetează dicționarul cu client.messages.create(**parametri) sau scrie fiecare parametru cu numele lui. Explicația completă → Ușor Repară tu TypeError: Responses.create() got an unexpected keyword argument 'messages' Ai trimis la OpenAI Responses API parametri din alt API (messages=, max_tokens=, system=). Responses primește conversația în input=, instrucțiunile în instructions= și limita în max_output_tokens=. La Claude e invers: messages=, system=, max_tokens=. Explicația completă → Ușor Repară tu TypeError: list.append() takes exactly one argument (2 given) append() adaugă un singur element în listă, iar tu i-ai dat două valori, de obicei rolul și textul separat. În istoricul conversației adaugi un dicționar: mesaje.append({"role": "user", "content": text}); pentru mai multe mesaje odată folosește extend([...]). Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - output_config.effort: Input should be 'low', 'medium', 'high', 'xhigh' or 'max' Ai dat parametrului effort o valoare pe care API-ul Claude nu o acceptă (de exemplu "minimal", "Low" sau "mic"). Valorile permise sunt exact "low", "medium", "high", "xhigh" și "max", scrise cu litere mici, în output_config={"effort": "low"}. Explicația completă → Mediu Repară tu anthropic.BadRequestError: Error code: 400 - thinking.type: 'enabled' with budget_tokens is not supported for this model; use {"type": "adaptive"} Modelele Claude actuale nu mai acceptă gândirea cu buget fix de tokeni (thinking={"type": "enabled", "budget_tokens": ...}). Folosește thinking={"type": "adaptive"} sau lasă parametrul deoparte, iar cât lucrează modelul îl reglezi cu output_config={"effort": ...}. Explicația completă → Mediu Repară tu anthropic.BadRequestError: Error code: 400 - thinking cannot be disabled for this model; lower output_config.effort instead Modelul ales (de exemplu Claude Opus 5.5) nu permite oprirea raționamentului cu thinking={"type": "disabled"}. Scoate parametrul thinking și, dacă voiai răspunsuri mai rapide și mai ieftine, folosește output_config={"effort": "low"} sau un model mai mic. Explicația completă → Citirea răspunsului de la model
AttributeError: 'Message' object has no attribute 'choices' Citești răspunsul de la Claude cu structura de la OpenAI (`response.choices[0].message.content`). Obiectul `Message` al SDK-ului `anthropic` nu are `choices`: textul e în blocurile din `response.content`, de exemplu `response.content[0].text`. Explicația completă → Ușor Repară tu TypeError: 'Message' object is not subscriptable Accesezi răspunsul SDK-ului ca pe un dicționar (`raspuns["content"]`), dar el e un obiect cu atribute. Folosește punctul: `raspuns.content[0].text`; dacă chiar îți trebuie un dicționar, transformă-l cu `raspuns.model_dump()`. Explicația completă → Mediu Repară tu AttributeError: 'ToolUseBlock' object has no attribute 'text' Ai citit `raspuns.content[0].text`, dar primul bloc nu e text: modelul a cerut un tool (`stop_reason == "tool_use"`), iar blocurile `tool_use` au `name` și `input`, nu `text`. Verifică `bloc.type` înainte să citești câmpurile și tratează apelul de tool. Explicația completă → Mediu Repară tu TypeError: Object of type TextBlock is not JSON serializable `json.dump` / `json.dumps` nu știe să salveze obiectele SDK-ului (`TextBlock`, `ToolUseBlock`, `Message`). Salvează textul (`bloc.text`) sau transformă obiectele în dicționare cu `bloc.model_dump()` înainte de `json.dumps`. Explicația completă → Ușor Repară tu AttributeError: 'Message' object has no attribute 'text' Obiectul Message întors de messages.create nu are câmpul text: textul e în lista de blocuri content. Citește-l cu r.content[0].text sau, mai sigur, unește textul tuturor blocurilor de tip text. Explicația completă → Ușor Repară tu AttributeError: 'list' object has no attribute 'text' r.content este o listă de blocuri, nu un singur bloc, deci nu are .text. Alege un bloc (r.content[0].text) sau parcurge lista și unește textul blocurilor de tip text. Explicația completă → Mediu Repară tu AttributeError: 'NoneType' object has no attribute 'strip' La OpenAI Chat Completions, message.content este None când modelul a ales să cheme un tool în loc să răspundă cu text. Verifică întâi message.tool_calls: dacă există, execută tool-urile; doar altfel citește și prelucrează content. Explicația completă → Ușor Repară tu AttributeError: 'Choice' object has no attribute 'content' La OpenAI Chat Completions, textul nu e direct pe choices[0], ci în mesajul din interior: r.choices[0].message.content. Choice are doar index, message, finish_reason și logprobs. Explicația completă → Ușor Repară tu AttributeError: 'Usage' object has no attribute 'prompt_tokens' Câmpurile de consum diferă între furnizori: la Claude, r.usage are input_tokens și output_tokens; prompt_tokens și completion_tokens sunt numele din OpenAI Chat Completions. Folosește numele potrivite SDK-ului pe care îl apelezi. Explicația completă → Mediu Repară tu AttributeError: 'MessageBatchErroredResult' object has no attribute 'message' Într-un lot (Message Batches API), unele cereri pot eșua; rezultatul lor are type 'errored' și un câmp error, nu message. Verifică rez.result.type == 'succeeded' înainte să citești rez.result.message, iar pe celelalte tratează-le separat. Explicația completă → Ușor Repară tu TypeError: can only concatenate str (not "list") to str Ai lipit un text de r.content, care la Claude este o listă de blocuri, nu un text. Ia textul din bloc cu r.content[0].text sau unește toate blocurile text: "".join(b.text for b in r.content if b.type == "text"). Explicația completă → Ușor Repară tu TypeError: sequence item 0: expected str instance, TextBlock found str.join() unește doar texte, iar lista dată conține blocuri TextBlock (de exemplu r.content). Unește textele din blocuri: "".join(b.text for b in r.content if b.type == "text"). Explicația completă → Mediu Repară tu KeyError: 'choices' Răspunsul JSON primit de la API nu are cheia choices, de obicei pentru că e un răspuns de eroare ({"error": {...}}): cheie greșită, limită depășită, model inexistent. Verifică întâi codul de stare și cheia error, apoi citește choices (sau folosește SDK-ul, care transformă erorile în excepții). Explicația completă → JSON de la model
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`. Explicația completă → Mediu Repară tu json.decoder.JSONDecodeError: Unterminated string starting at: line 1 column 95 (char 94) JSON-ul de la model e tăiat la mijloc: răspunsul s-a oprit la `max_tokens` (`stop_reason == "max_tokens"`) înainte să închidă ghilimelele și acoladele. Mărește `max_tokens`, verifică `stop_reason` înainte de `json.loads` și cere câmpuri mai scurte. Explicația completă → Ușor Repară tu TypeError: the JSON object must be str, bytes or bytearray, not list Ai dat lui `json.loads` lista de blocuri `raspuns.content`, nu textul din ea. `json.loads` primește doar text: folosește `json.loads(raspuns.content[0].text)` (sau textul lipit din blocurile `text`). Explicația completă → Mediu Repară tu KeyError: 'email' JSON-ul primit de la model nu are cheia pe care o citești (`date["email"]`): modelul a omis-o pentru că informația lipsea din text sau a numit-o altfel. Folosește `date.get("email")` cu o valoare implicită și cere câmpul în schemă (`required`), cu `null` permis când lipsește. Explicația completă → Ușor Repară tu 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. Explicația completă → Mediu Repară tu json.decoder.JSONDecodeError: Extra data: line 2 column 1 (char 41) Textul începe cu un JSON valid, dar după el mai urmează ceva: o explicație a modelului, un al doilea obiect sau un bloc de cod. json.loads acceptă un singur document. Cere ieșire structurată ca modelul să întoarcă doar JSON, sau extrage primul obiect cu json.JSONDecoder().raw_decode. Explicația completă → Ușor Repară tu TypeError: list indices must be integers or slices, not str JSON-ul primit de la model este o listă ([...]), iar codul îl citește ca pe un dicționar, cu date["nume"]. Parcurge lista (for produs in date) sau alege un element (date[0]["nume"]); și mai bine, fixează forma răspunsului printr-o schemă. Explicația completă → Ușor Repară tu ValueError: invalid literal for int() with base 10: '4 stele' Ai cerut modelului un număr și ai pus răspunsul direct în int(), dar textul conține și altceva („4 stele”, „Nota: 4”, „4.”). Extrage cifrele cu o expresie regulată sau cere un câmp integer printr-o schemă JSON, apoi convertește. Explicația completă → Ușor Repară tu ValueError: could not convert string to float: '248,50' float() acceptă doar punctul ca separator zecimal, iar modelul a scris suma în format românesc: virgulă pentru zecimale și, uneori, punct pentru mii („1.032,00”). Normalizează textul înainte de conversie sau cere suma ca number printr-o schemă JSON. Explicația completă → Ușor Repară tu TypeError: '>' not supported between instances of 'str' and 'int' Valoarea din JSON-ul modelului a venit ca text ("8"), nu ca număr (8), iar Python nu compară text cu numere. Convertește cu int() sau float() înainte de comparație și cere tipul corect (integer, number) în schema JSON. Explicația completă → Mediu Repară tu json.decoder.JSONDecodeError: Invalid control character at: line 1 column 79 (char 78) În interiorul unui șir din JSON există un caracter de control neescapat, de obicei un Enter real (newline) sau un Tab. JSON-ul strict cere \n în loc de rând nou. Folosește json.loads(text, strict=False) sau ieșirea structurată, care produce mereu JSON corect escapat. Explicația completă → Ușor Repară tu 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. Explicația completă → Ușor Repară tu AttributeError: 'NoneType' object has no attribute 'group' re.search() nu a găsit nimic în răspunsul modelului și a întors None, iar tu ai cerut .group() direct. Verifică rezultatul înainte (if m:), tratează cazul fără potrivire și, pentru JSON, preferă ieșirea structurată în locul extragerii cu regex. Explicația completă → Ușor Repară tu TypeError: unsupported operand type(s) for +: 'int' and 'str' Faci o adunare (de obicei cu sum()) pe valori care sunt texte, nu numere: modelul a pus în JSON "120" în loc de 120. Convertește fiecare valoare cu float() sau int() înainte de calcul și cere în schema JSON tipul number. Explicația completă → Mediu Repară tu ValueError: 'urgent' is not a valid Prioritate Modelul a întors o valoare care nu există în Enum-ul tău (de exemplu "urgent", când ai doar mica, medie, mare). Restrânge valorile în prompt sau în schema JSON cu enum, normalizează textul înainte de conversie și tratează valorile necunoscute. Explicația completă → Mediu Repară tu ValueError: malformed node or string on line 1: Name(id='true', ctx=Load()) ast.literal_eval() citește literali Python, nu JSON: textul modelului conține true, false sau null, care în Python nu există. Folosește json.loads() pentru JSON; literal_eval doar pentru text în sintaxă Python. Explicația completă → Tool use și function calling
anthropic.BadRequestError: Error code: 400 - messages.2: `tool_use` ids were found without `tool_result` blocks immediately after: toolu_01A09q90qw90lq917835lq9. Each `tool_use` block must have a corresponding `tool_result` block in the next message. Modelul a cerut un tool (bloc `tool_use`), iar mesajul următor din conversație nu conține rezultatul lui. Imediat după mesajul `assistant` cu `tool_use`, trimite un mesaj `user` cu un bloc `{"type": "tool_result", "tool_use_id": bloc.id, "content": "..."}` pentru fiecare apel. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - tools.0.input_schema: Field required Definiția tool-ului trimisă la Claude nu are câmpul `input_schema`. De obicei e o definiție în format OpenAI (`parameters` sau `{"type": "function", "function": {...}}`): la Claude, tool-ul are `name`, `description` și `input_schema`, o schemă JSON de tip `object`. Explicația completă → Ușor Repară tu TypeError: string indices must be integers, not 'str' La OpenAI, `item.arguments` dintr-un `function_call` este text JSON, nu dicționar, deci `item.arguments["oras"]` dă eroarea. Parsează-l întâi: `args = json.loads(item.arguments)`, apoi `args["oras"]`. Explicația completă → Mediu Repară tu openai.BadRequestError: Error code: 400 - No tool call found for function call output with call_id call_abc123. Ai trimis la OpenAI un `function_call_output`, dar în `input` nu există apelul de funcție (`function_call`) cu același `call_id`. Înainte să adaugi rezultatele, adaugă în listă item-urile din răspunsul modelului: `intrari += r.output`. Explicația completă → Mediu Repară tu TypeError: verifica_stoc() got an unexpected keyword argument 'marime' Ai apelat funcția tool-ului cu argumentele modelului (`functie(**bloc.input)`), iar modelul a trimis un argument pe care funcția nu îl are. Fă funcția să accepte toate proprietățile din schemă (cu valori implicite pentru cele opționale) și validează argumentele înainte de apel. Explicația completă → Mediu Repară tu TypeError: 'NoneType' object is not iterable La OpenAI Chat Completions, message.tool_calls este None (nu o listă goală) când modelul răspunde direct cu text. Un for apel in msg.tool_calls cade atunci. Verifică întâi if msg.tool_calls: sau parcurge msg.tool_calls or []. Explicația completă → Mediu Repară tu TypeError: verifica_stoc() argument after ** must be a mapping, not str La OpenAI, argumentele unui function call vin ca text JSON (apel.arguments este un str), iar ** cere un dicționar. Parsează-le întâi: functie(**json.loads(apel.arguments)). La Claude, bloc.input e deja dicționar. Explicația completă → Mediu Repară tu AttributeError: 'dict' object has no attribute 'type' Blocurile conversației au ajuns dicționare (după json.load, model_dump sau când le-ai construit tu), dar codul le citește ca pe obiectele SDK-ului, cu b.type. Pe dicționare folosește b["type"], b["name"], b["input"]. Explicația completă → Mediu Repară tu openai.BadRequestError: Error code: 400 - Invalid schema for function 'rezerva_masa': In context=(), 'additionalProperties' is required to be supplied and to be false. Cu "strict": True, OpenAI cere ca schema fiecărui obiect din parametrii tool-ului să aibă "additionalProperties": False și ca toate proprietățile să fie în required. Adaugă additionalProperties: False la fiecare nivel de obiect; câmpurile opționale le faci de tip ["string", "null"]. Explicația completă → Mediu Repară tu KeyError: 'cauta_comanda' Modelul a cerut un tool după numele din definiția lui (block.name), iar dicționarul tău de funcții nu are cheia aceea, de obicei din cauza unui nume scris diferit. Folosește aceleași nume în tools și în dispecer și tratează numele necunoscute cu un tool_result cu is_error: True. Explicația completă → Mediu Repară tu TypeError: can't multiply sequence by non-int of type 'float' Ai înmulțit un text cu un număr zecimal: argumentul primit de la model (de exemplu pret="120") este str, nu număr. Declară parametrul ca "number" în input_schema și convertește-l totuși cu float() în funcție, înainte de calcul. Explicația completă → Mediu Repară tu anthropic.BadRequestError: Error code: 400 - tool_choice: type "tool" and "any" are not supported for this model. Modelul ales (Claude Opus 5.5 sau Sonnet 5.5) nu acceptă forțarea unui tool cu tool_choice={"type": "any"} sau {"type": "tool", ...}. Lasă tool_choice implicit (auto) și spune în system prompt când trebuie folosit tool-ul. Explicația completă → Rate limit, suprasolicitare, timeout și retry
anthropic.RateLimitError: Error code: 429 - rate_limit_error: Number of request tokens has exceeded your per-minute rate limit Ai trimis prea multe cereri sau prea mulți tokeni într-un minut pentru limita contului tău. Eroarea e temporară: așteaptă cât spune antetul `retry-after` și reîncearcă. Lasă SDK-ul să reîncerce (`max_retries`, implicit 2) sau scrie un backoff exponențial cu jitter, și rărește cererile. Explicația completă → Mediu Repară tu anthropic.InternalServerError: Error code: 529 - {'type': 'error', 'error': {'type': 'overloaded_error', 'message': 'Overloaded'}} Serverele Anthropic sunt temporar suprasolicitate; nu e vina codului sau a contului tău. Reîncearcă după o pauză (SDK-ul o face automat de 2 ori), iar pentru aplicațiile importante pregătește un plan B: alt model sau alt furnizor, plus un mesaj prietenos pentru utilizator. Explicația completă → Ușor Repară tu anthropic.APIConnectionError: Connection error. Cererea nu a ajuns la server sau răspunsul nu a ajuns înapoi: problemă de rețea, DNS, proxy, firewall sau o întrerupere scurtă. Verifică conexiunea și setările de proxy, lasă SDK-ul să reîncerce (`max_retries`) și prinde `APIConnectionError` cu un mesaj prietenos. Explicația completă → Mediu Repară tu anthropic.APITimeoutError: Request timed out. Răspunsul nu a venit în timpul permis de client (`timeout`). Apare la răspunsuri lungi, la un timeout setat prea mic sau la rețea lentă. Mărește `timeout`, păstrează reîncercările, folosește streaming pentru răspunsurile lungi și cere răspunsuri mai scurte. Explicația completă → Ușor Repară tu AttributeError: 'RateLimitError' object has no attribute 'status' Codul HTTP al unei erori de API se citește cu e.status_code, nu cu e.status. Excepțiile SDK-urilor anthropic și openai au status_code, message, body, response și request_id. Explicația completă → Mediu Repară tu openai.InternalServerError: Error code: 503 - The server is overloaded or not ready yet. Serverele OpenAI sunt temporar suprasolicitate; cererea ta nu are nicio problemă. Reîncearcă după o pauză, cu backoff exponențial: setează max_retries mai mare pe client (sau cu with_options pentru apelurile importante) și prinde InternalServerError ca să afișezi un mesaj prietenos. Explicația completă → Ușor Repară tu NameError: name 'RateLimitError' is not defined Ai scris except RateLimitError:, dar numele nu e importat: excepțiile SDK-ului stau în modul. Scrie except anthropic.RateLimitError: (sau openai.RateLimitError), ori importă explicit: from anthropic import RateLimitError. Explicația completă → Mediu Repară tu TypeError: float() argument must be a string or a real number, not 'NoneType' Ai citit header-ul retry-after cu headers.get(), dar răspunsul nu îl conținea, așa că float() a primit None. Folosește o valoare de rezervă: float(e.response.headers.get("retry-after") or 2 ** incercare), adică backoff exponențial când header-ul lipsește. Explicația completă → Mediu Repară tu UnboundLocalError: cannot access local variable 'r' where it is not associated with a value Toate încercările din bucla de retry au eșuat, deci variabila cu răspunsul nu a primit niciodată valoare, iar return r o folosește oricum. Întoarce răspunsul din interiorul try și, după buclă, tratează explicit cazul în care nicio încercare n-a reușit. Explicația completă → Fereastra de context și max_tokens
anthropic.BadRequestError: Error code: 400 - prompt is too long: 1048712 tokens > 1000000 maximum Tot ce trimiți (system prompt, istoricul conversației, documentele, tool-urile) depășește fereastra de context a modelului. Scurtează cererea: păstrează doar ultimele mesaje, rezumă istoricul vechi și trimite doar bucățile relevante din documente (RAG), nu documentele întregi. Explicația completă → Mediu Repară tu openai.BadRequestError: Error code: 400 - This model's maximum context length is 272000 tokens. However, your messages resulted in 289114 tokens. Please reduce the length of the messages. Cererea trimisă la OpenAI are mai mulți tokeni decât fereastra de context a modelului (`context_length_exceeded`). Scurtează mesajele: taie istoricul vechi, trimite doar fragmentele relevante din documente și limitează rezultatele tool-urilor. Explicația completă → Ușor Repară tu anthropic.BadRequestError: Error code: 400 - max_tokens: 200000 > 128000, which is the maximum allowed number of output tokens for claude-haiku-5-5 Ai cerut un `max_tokens` mai mare decât poate genera modelul într-un răspuns. Pune o valoare sub limita modelului, pe măsura răspunsului de care ai nevoie (de exemplu 1000–4000 pentru texte obișnuite), și verifică `stop_reason` ca să știi dacă răspunsul a fost tăiat. Explicația completă → Ușor Repară tu TypeError: Messages.count_tokens() got an unexpected keyword argument 'max_tokens' client.messages.count_tokens numără doar tokenii de intrare ai unei cereri, deci nu acceptă max_tokens (și nici stream sau stop_sequences). Trimite-i doar model, messages și, dacă există, system și tools; max_tokens rămâne pentru messages.create. Explicația completă → Ușor Repară tu TypeError: '>' not supported between instances of 'MessageTokensCount' and 'int' count_tokens() întoarce un obiect MessageTokensCount, nu un număr, iar tu l-ai comparat direct cu limita. Compară atributul lui: client.messages.count_tokens(...).input_tokens > LIMITA. Explicația completă → Embeddings și RAG
AttributeError: 'list' object has no attribute 'embedding' `response.data` din `client.embeddings.create(...)` este o listă, cu câte un element pentru fiecare text trimis. Vectorul unui text se citește cu `response.data[0].embedding`; pentru mai multe texte, `[d.embedding for d in response.data]`. Explicația completă → Greu Repară tu ValueError: zip() argument 2 is longer than argument 1 Compari doi vectori de embeddings cu lungimi diferite: de obicei indexul a fost construit cu alt model sau cu alt `dimensions` decât întrebarea. Generează vectorii documentelor și ai întrebării cu același model și aceleași setări, și verifică `len(a) == len(b)` înainte de similaritate. Explicația completă → Ușor Repară tu FileNotFoundError: [Errno 2] No such file or directory: 'index_vectori.json' Programul încearcă să încarce indexul de embeddings salvat pe disc, dar fișierul nu există încă (prima rulare, alt director de lucru sau alt nume). Verifică os.path.exists înainte: dacă lipsește, calculează vectorii, salvează-i, iar la rulările următoare încarcă-i. Explicația completă → Mediu Repară tu UnicodeDecodeError: 'charmap' codec can't decode byte 0x9d in position 80: character maps to <undefined> Fișierul e salvat în UTF-8 (cu diacritice și ghilimele „”), dar a fost deschis cu altă codificare: pe Windows, open() fără encoding folosește cp1252. Deschide documentele mereu cu open(cale, encoding="utf-8"). Explicația completă → Ușor Repară tu openai.BadRequestError: Error code: 400 - '$.input' is invalid. Please check the API reference: https://platform.openai.com/docs/api-reference. Lista trimisă la embeddings.create conține un text gol (sau ceva care nu e text, de exemplu None). De obicei vine din împărțirea documentului: split("\n\n") lasă bucăți goale la final sau între secțiuni. Filtrează bucățile goale înainte de apel. Explicația completă → Ușor Repară tu ValueError: max() iterable argument is empty Ai apelat max() pe o listă goală: după filtrare (departament, prag de similaritate, dată), niciun document n-a rămas. Verifică lista înainte, sau folosește max(..., default=None), și răspunde explicit că nu ai găsit surse, în loc să lași programul să cadă. Explicația completă → Mediu Repară tu TypeError: '<' not supported between instances of 'dict' and 'dict' Sortezi perechi (scor, document) cu sorted(), iar două documente au exact același scor. La egalitate, Python compară al doilea element, adică dicționarele, care nu au ordine. Sortează doar după scor: sorted(rezultate, key=lambda x: x[0], reverse=True). Explicația completă → Ușor Repară tu ValueError: range() arg 3 must not be zero La chunking cu suprapunere, pasul este mărime - suprapunere. Când suprapunerea e egală cu mărimea bucății, pasul devine 0, iar range() nu poate avansa. Suprapunerea trebuie să fie mai mică decât bucata (de obicei 10–20% din ea); verifică asta la începutul funcției. Explicația completă → Mediu Repară tu ZeroDivisionError: float division by zero Similaritatea cosinus împarte la produsul lungimilor celor doi vectori, iar unul dintre ei are lungimea 0 (un vector numai din zerouri, pus ca înlocuitor pentru un text gol sau un embedding eșuat). Nu pune vectori de zero în index; dacă există, sari peste ei sau întoarce 0.0 când norma e 0. Explicația completă → Ușor Repară tu TypeError: sort() takes no positional arguments Ai dat funcția de ordonare ca argument pozițional: lista.sort(lambda x: x[1]). În Python 3, funcția se dă cu numele key: rezultate.sort(key=lambda x: x[1], reverse=True), ca bucățile cele mai asemănătoare să ajungă primele. Explicația completă → Mediu Repară tu TypeError: unhashable type: 'list' Ai folosit o listă (un vector de embedding sau o listă de texte) drept cheie de dicționar sau element de set. Listele se pot modifica, deci nu pot fi chei. Folosește drept cheie textul (str) sau un tuple(...), de exemplu cache[text] = vector. Explicația completă → Ușor Repară tu TypeError: slice indices must be integers or None or have an __index__ method Ai tăiat un text sau o listă cu limite calculate prin împărțire (/), care dau float, de exemplu text[0:len(text) / 3]. Felierea cere întregi: folosește împărțirea întreagă // sau math.ceil(...) pentru dimensiunea bucății. Explicația completă → Ușor Repară tu TypeError: 'float' object cannot be interpreted as an integer range() primește doar întregi, iar pasul dintre bucăți l-ai calculat ca float, de obicei marime * (1 - suprapunere). Convertește pasul cu int(...) sau calculează suprapunerea în caractere întregi: pas = marime - suprapunere. Explicația completă → Ușor Repară tu TypeError: expected string or bytes-like object, got 'list' Ai dat unei funcții din re (split, sub, findall) o listă în loc de text, de obicei rezultatul lui readlines(). Citește fișierul ca un singur text cu f.read() sau aplică funcția pe fiecare element al listei. Explicația completă → Streaming
TypeError: can only concatenate str (not "NoneType") to str În streaming-ul OpenAI Chat Completions, ultima bucată (cea cu finish_reason) și uneori prima au delta.content = None. Adunarea text += None cade. Folosește chunk.choices[0].delta.content or "" sau sari peste bucățile fără conținut. Explicația completă → Mediu Repară tu AttributeError: 'RawMessageStartEvent' object has no attribute 'delta' Cu messages.create(stream=True), primești evenimente de mai multe tipuri, iar doar content_block_delta are delta cu text. Primul eveniment e message_start, fără delta. Verifică event.type == "content_block_delta" (și delta.type == "text_delta") sau folosește client.messages.stream(...) cu text_stream. Explicația completă → Ușor Repară tu AttributeError: 'Stream' object has no attribute 'content' Cu stream=True, messages.create nu mai întoarce un Message, ci un Stream de evenimente, care nu are content. Dacă ai nevoie de răspunsul întreg dintr-odată (JSON, salvare, procesare), scoate stream=True; dacă vrei streaming, parcurge evenimentele sau folosește messages.stream. Explicația completă → Ușor Repară tu AttributeError: 'MessageStreamManager' object has no attribute 'text_stream' client.messages.stream(...) întoarce un manager de context, care pornește cererea abia la intrarea într-un bloc with. Scrie with client.messages.stream(...) as stream: și folosește stream.text_stream în interiorul blocului. Explicația completă → Ușor Repară tu TypeError: 'generator' object is not callable Ai pus paranteze după stream.text_stream, dar text_stream e o proprietate care îți dă deja un generator, nu o metodă. Scrie for text in stream.text_stream: (fără ()), în interiorul blocului with. Explicația completă → Ușor Repară tu AttributeError: 'function' object has no attribute 'usage' Ai uitat parantezele la o metodă, de obicei stream.get_final_message, așa că variabila ține metoda, nu mesajul. Apelează metoda: mesaj = stream.get_final_message(), apoi citește mesaj.usage.output_tokens. Explicația completă → Șabloane de prompt și formatarea textului
KeyError: '"nume"' Șablonul promptului conține un exemplu JSON cu acolade, iar str.format() crede că {"nume": ...} e un câmp de completat. Dublează acoladele din exemplu ({{ și }}) sau construiește promptul fără format(), de exemplu cu concatenare sau string.Template. Explicația completă → Mediu Repară tu ValueError: Single '}' encountered in format string Șablonul de prompt are o acoladă singură care nu face parte dintr-un câmp: de obicei ai dublat acolada de deschidere a unui exemplu JSON ({{), dar nu și pe cea de închidere. Dublează fiecare acoladă de text: {{ și }}. Explicația completă → Ușor Repară tu IndexError: Replacement index 1 out of range for positional args tuple Șablonul are mai multe câmpuri {} decât valorile date lui format(). Dă câte o valoare pentru fiecare {} sau, mai sigur, folosește câmpuri cu nume ({produs}, {intrebare}) și format(produs=..., intrebare=...). Explicația completă → Mediu Repară tu ValueError: Invalid format specifier ' "Ana"' for object of type 'str' Ai pus un exemplu JSON direct într-un f-string, iar Python a citit {"nume": "Ana"} ca expresia "nume" urmată de specificatorul de format "Ana". Dublează acoladele exemplului în f-string ({{ și }}) sau adaugă exemplul JSON separat, fără f-string. Explicația completă → Nicio eroare nu se potrivește căutării. Încearcă doar partea fixă a mesajului (fără numele variabilelor).
Erori explicate la alte tehnologii
Î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.
