...
Eroare Aplicații AI cu LLM · Citirea răspunsului de la model

KeyError: 'choices'

Pe scurt

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

Greșit
PYTHON
date = raspuns_http.json()
text = date["choices"][0]["message"]["content"]
Corect
PYTHON
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

Greșit
PYTHON
r = requests.post(URL, json=cerere, headers=h)
date = r.json()
Corect
PYTHON
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

Greșit
PYTHON
text = date["choices"][0]["message"]["content"]   # răspuns Claude
Corect
PYTHON
text = date["content"][0]["text"]   # răspuns Claude

Fiecare API are structura lui: Claude întoarce content, Chat Completions choices, Responses output.

Repară tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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"].

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 cheia error î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

← 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.