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.
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
text = ""
for chunk in stream:
text += chunk.choices[0].delta.contenttext = ""
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
print(chunk.choices[0].delta.content, end="")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ă 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>.
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))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 ""
Reparația
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 or ""
text += parte
print(parte, end="")
print()
print("Caractere:", len(text))De ce merge
Ultima bucată dintr-un stream Chat Completions anunță doar motivul opririi (finish_reason), iar delta.content e None. text += None aruncă TypeError. Cu or "", bucățile fără conținut devin text gol, deci nu adaugă nimic și nu afișează nimic, iar textul complet se adună corect.
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 ""sauif parte:). - Adună bucățile într-o listă și unește-le la final cu
"".join(...), după ce ai filtratNone. - 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
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. 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. 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. Î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.
