...
Eroare Aplicații AI cu LLM · Streaming

TypeError: can only concatenate str (not "NoneType") to str

Pe scurt

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

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

Ce înseamnă

+ între un str și None nu are sens, iar Python spune exact asta: poate concatena la un text doar alt text. În aplicațiile cu LLM, None vine aproape mereu dintr-un stream.

Cu stream=True, Chat Completions trimite răspunsul în bucăți (ChatCompletionChunk). Fiecare are choices[0].delta, care conține doar ce s-a schimbat: prima bucată poate avea doar role, bucățile din mijloc au content, iar ultima are doar finish_reason, cu content egal cu None. La tool calls, bucățile au tool_calls, iar content e tot None.

Codul care adună orbește delta.content merge până la ultima bucată, deci vezi tot textul pe ecran și eroarea abia la final.

De ce apare: cauzele frecvente

1Ultima bucată fără conținut

Greșit
PYTHON
text = ""
for chunk in stream:
    text += chunk.choices[0].delta.content
Corect
PYTHON
text = ""
for chunk in stream:
    text += chunk.choices[0].delta.content or ""

or "" transformă None în text gol, deci adunarea merge pentru orice bucată.

2Afișare și adunare fără verificare

Greșit
PYTHON
print(chunk.choices[0].delta.content, end="")
Corect
PYTHON
parte = chunk.choices[0].delta.content
if parte:
    print(parte, end="")

print(None) nu dă eroare, dar afișează textul None la final. Verificarea sare peste bucățile goale.

Repară tu

Repară eroarea, direct în pagină

Programul afișează răspunsul pe măsură ce vine (streaming cu Chat Completions) și îl adună în text, dar la final cade cu can only concatenate str (not "NoneType") to str. Repară bucla: sari peste bucățile fără conținut, afișează restul pe același rând, iar la final afișează Caractere: <lungime>.

Codul care dă eroarea
PYTHON
from openai import OpenAI

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

stream = client.chat.completions.create(
    model=MODEL,
    messages=[{"role": "user", "content": "Scrie o poveste de o propoziție despre un far."}],
    stream=True,
)
text = ""
for chunk in stream:
    parte = chunk.choices[0].delta.content
    text += parte
    print(parte, end="")
print()
print("Caractere:", len(text))
După reparație, programul afișează
A fost odată un far care număra corăbiile ce treceau pe lângă el.
Caractere: 65
Indiciu

parte = chunk.choices[0].delta.content or ""

Alte forme ale mesajului

  • TypeError: unsupported operand type(s) for +=: 'NoneType' and 'str'
  • TypeError: sequence item 12: expected str instance, NoneType found

Cum o eviți pe viitor

  • La fiecare stream, tratează bucățile fără conținut (or "" sau if parte:).
  • Adună bucățile într-o listă și unește-le la final cu "".join(...), după ce ai filtrat None.
  • Folosește Responses API cu evenimentele response.output_text.delta, care conțin mereu text.

Întrebări frecvente

De ce eroarea apare abia după ce s-a afișat tot textul?

Bucățile cu text vin primele; cea fără conținut e ultima, cu finish_reason. Eroarea apare la ea, după ce restul răspunsului a fost deja adunat.

Varianta cu „sequence item ... expected str instance, NoneType found” de unde vine?

Din "".join(bucati), când lista conține și None. Cauza e aceeași: filtrează bucățile fără conținut.

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.