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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
KeyError: 'choices' apare când apelezi API-ul direct prin HTTP (de exemplu cu requests.post(...).json()) și citești rezultatul ca pe un dicționar. Un răspuns reușit de la Chat Completions are cheia choices. Unul eșuat are cu totul altă formă: {"error": {"message": ..., "type": ..., "code": ...}}, fără choices.
Codul care presupune că orice răspuns e reușit merge cât timp totul e bine și cade la prima eroare: cheie invalidă, rate limit, cerere prea mare. Mesajul real al problemei e chiar în date["error"]["message"], așa că afișează-l.
La API-ul Claude prin HTTP, aceeași greșeală dă KeyError: 'content', iar răspunsul de eroare are forma {"type": "error", "error": {...}}.
De ce apare: cauzele frecvente
1Răspunsul de eroare citit ca unul reușit
date = raspuns_http.json()
text = date["choices"][0]["message"]["content"]date = raspuns_http.json()
if "error" in date:
print("Eroare API:", date["error"]["message"])
else:
text = date["choices"][0]["message"]["content"]Verifici întâi dacă API-ul a întors o eroare; doar răspunsurile reușite au choices.
2Codul de stare HTTP ignorat
r = requests.post(URL, json=cerere, headers=h)
date = r.json()r = requests.post(URL, json=cerere, headers=h)
if r.status_code != 200:
raise RuntimeError(r.text)
date = r.json()Un cod diferit de 200 înseamnă că răspunsul nu are forma obișnuită.
3Cheia altui API
text = date["choices"][0]["message"]["content"] # răspuns Claudetext = date["content"][0]["text"] # răspuns ClaudeFiecare API are structura lui: Claude întoarce content, Chat Completions choices, Responses output.
Repară eroarea, direct în pagină
Un script vechi a apelat Chat Completions direct prin HTTP și a salvat răspunsurile brute în raspunsuri.json. Programul cade cu KeyError: 'choices' la un răspuns de eroare. Repară bucla: pentru un răspuns cu cheia error, afișează Eroare API: <mesaj>, iar pentru celelalte afișează textul.
import json
with open("raspunsuri.json", encoding="utf-8") as f:
raspunsuri = json.load(f)
for date in raspunsuri:
text = date["choices"][0]["message"]["content"]
print("Răspuns:", text)Răspuns: Coletul tău este în livrare și ajunge mâine. Eroare API: Rate limit reached for gpt-6-luna on requests per min (RPM). Please try again in 2s. Răspuns: Returul se face în 14 zile de la primire.
Indiciu
if "error" in date: înainte de date["choices"].
Reparația
import json
with open("raspunsuri.json", encoding="utf-8") as f:
raspunsuri = json.load(f)
for date in raspunsuri:
if "error" in date:
print("Eroare API:", date["error"]["message"])
continue
text = date["choices"][0]["message"]["content"]
print("Răspuns:", text)De ce merge
Răspunsurile de eroare ale API-ului nu au choices, ci un obiect error cu message, type și code. Verificând întâi cheia error, tratezi separat eșecul și afișezi mesajul real, iar pentru răspunsurile reușite citești textul ca înainte. Bucla merge mai departe și nu se oprește la primul răspuns eșuat.
Alte forme ale mesajului
KeyError: 'content'KeyError: 'output'KeyError: 'message'
Cum o eviți pe viitor
- Folosește SDK-ul oficial: el verifică codul de stare și ridică excepții clare (
RateLimitError,AuthenticationError). - Dacă lucrezi direct prin HTTP, verifică
status_codeși cheiaerrorînainte de orice altă citire. - Salvează în log răspunsurile neașteptate întregi, ca să vezi mesajul real al erorii.
Întrebări frecvente
Codul mergea ieri. De ce apare acum?
Pentru că ieri toate răspunsurile au fost reușite. Azi a venit unul de eroare (limită, cheie expirată, credit epuizat), iar codul nu era pregătit pentru el.
Cu SDK-ul pot primi KeyError: 'choices'?
Nu în forma asta: SDK-ul întoarce obiecte (r.choices[0].message.content) și transformă erorile în excepții. Un KeyError apare doar când lucrezi cu dicționare, de obicei din HTTP direct sau din răspunsuri salvate în fișiere.
Erori înrudite
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. 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. 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. Î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.
