LLM API-antwoord leeg? Oorzaken en oplossingen
Wanneer een fout 'LLM API-antwoord leeg' verschijnt, antwoordde de server meestal wel en komt de lege string voort uit hoe het antwoord wordt gelezen. Hier is een checklist, gerangschikt op frequentie van voorkomen.
BijgewerktUnfiltered AI

Belangrijkste punten
- Druk eerst de ruwe JSON af. De meeste lege antwoorden zijn een parsingsprobleem, geen uitval.
- Controleer finish_reason: length, stop en tool_calls verklaren elk een leeg content-veld.
- Lees in streams delta.content verdedigend en sla brokken over zonder keuzes.
- Een 429 of een proxy die SSE buffert kan in sommige clients lijken op een leeg antwoord.
Start door de ruwe respons te bekijken
Voordat je instellingen wijzigt, leg vast wat er terugkwam. Wrapperbibliotheken verbergen de oorzaak: een ruwe print(response.choices[0].message.content) toont None of een lege string, wat aangeeft of de body leeg was, een toolaanroep bevatte, eindigde op een lengtebeperking of nooit aankwam.
Gebruik curl zodat er geen clientcode in de weg staat, en voeg de headers toe met -i:
curl -i https://api.unfilteredaiapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Say hello in five words."}]
}'
Lees drie dingen in het resultaat. Eerst de statusregel: 200 betekent dat er een completie is gegenereerd, 429 betekent dat een limiet is bereikt, een authenticatiefout zoals 401 wijst meestal naar de sleutel. Tweedens, choices[0].finish_reason. Derdens de antwoordkoppen, met name X-Request-Id (bewaar deze als je ondersteuning contacteert) en X-Balance-USD, die aangeeft of het account nog tegoed heeft. Als deze curl-oproep tekst retourneert, werkt de service en ligt het probleem bij je client. Als het een foutlichaam retourneert, heb je de oorzaak al.
Oorzaak 1: het bericht bevat een toolaanroep, geen tekst
Als je tools doorgeeft en het model besluit er een aan te roepen, heeft het assistantbericht tool_calls en is content null of leeg. Code die alleen content leest, ziet een leeg antwoord. De oplossing is eerst controleren op toolaanroepen, de functie uitvoeren, het resultaat als bericht met role: "tool" toevoegen en de API opnieuw aanroepen.
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "What is the weather in Oslo?"}],
tools=[{
"type": "function",
"function": {
"name": "get_weather",
"description": "Get current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}],
)
msg = resp.choices[0].message
if msg.tool_calls:
print("tool call:", msg.tool_calls[0].function.name, msg.tool_calls[0].function.arguments)
else:
print(msg.content)
Als je geen tools wilde aanbieden, verwijder dan de velden tools en tool_choice. Een achtergelaten tooldefinitie uit een eerdere test is een klassieke reden voor lege tekst.
Oorzaak 2: het antwoord werd afgekapt of begon nooit
finish_reason verklaart het meeste van de rest.
- length. De completie raakte een tokenlimiet. Je hebt misschien
max_tokenserg laag ingesteld, zoals 1 of 10. De parameter is hier optioneel, omdat de completie kan gebruiken wat er overblijft van het 100.000-token contextvenster, dus de eenvoudigste oplossing is om het te verwijderen. Als je een limiet nodig hebt, stel deze dan met ruime marge in. - stop. Het model is normaal beëindigd, of het produceerde een van je
stopstrings. Een stopsequentie zoals een nieuwe regel stopt het antwoord bij de eerste regeleinde, wat kan leiden tot niets als het model begint met een lege regel. Verwijder of verzwak de sequentie. - tool_calls. Zie de vorige sectie.
Contextoverloop is het andere lengteprobleem. Het venster is 100.000 tokens, tellend prompt en completie samen. Als een chatgeschiedenis is gegroeid tot bijna vulling, is er bijna geen ruimte meer over om te antwoorden. Knip oude wisselingen of vat ze samen. De pagina over gesprekgeheugen en het lange contextvenster toont manieren om de geschiedenis onder controle te houden. Een request body mag ook niet groter zijn dan 8 MB.
Een andere kleine valkuil: JSON-modus. Met response_format ingesteld op json_object, voeg het woord JSON toe aan je instructies en beschrijf de gewenste vorm. Een vaag prompt plus JSON-modus produceert dunne of triviale uitvoer die leeg lijkt zodra je een sleutel eruit haalt.
Oorzaak 3: streaming wordt verkeerd gelezen
Streaming via SSE stuurt vele kleine brokken. Niet elk brok bevat tekst. Het eerste brok heeft vaak alleen de rol, het laatste contentbrok bevat een finish_reason met een lege delta, en het laatste brok dat gebruik rapporteert kan aankomen met een lege choices lijst. Code die choices[0] indexeert op elk brok crasht, en code die een brok zonder tekst behandelt als het hele antwoord print niets.
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write two sentences about rain."}],
stream=True,
)
parts = []
for chunk in stream:
if not chunk.choices:
continue
delta = chunk.choices[0].delta
if delta.content:
parts.append(delta.content)
text = "".join(parts)
print(text if text else "[no content received]")
Twee omgevingsproblemen lijken ook op lege streams. Een reverse proxy of CDN die antwoorden bufferen houdt alle brokken vast tot het einde, dus een browser ziet niets voor een lange tijd en dan alles in één keer, of een time-out treedt eerst in werking. Schakel responsbuffering uit voor de streaming-route in je proxy. En een stream bezet zijn concurrency-slot tot het eind, dus verwaarloosde streams (een gesloten tabblad, een ontbrekende close()) zullen geleidelijk je 8 slots opbruiken. Het volgende verzoek krijgt dan een 429 in plaats van tekst. Voor een volledig servervoorbeeld, zie de FastAPI-backend met SSE-streaming.
Oorzaak 4: een fout die je client opslokte
Sommige HTTP-wrappers retourneren een lege string bij een niet-200-status in plaats van een fout te gooien. Log de statuscode en body voor elke fout. De gevallen die ertoe doen:
| Status of code | Betekenis | Wat te doen |
|---|---|---|
429, rate_limited | Meer dan 300 verzoeken per minuut op een volledige sleutel (60 op proef) | Vertraag, voeg een wachtrij toe |
429, concurrency | Meer dan 8 verzoeken tegelijk op een volledige sleutel (2 op proef) | Beperk je workers |
429 met Retry-After: 5 | Tijdelijke overbelasting | Wacht 5 seconden en probeer opnieuw |
| 401 | Typisch een ontbrekende of verkeerde sleutel | Controleer de Authorization: Bearer header |
| 404 | Typisch een verkeerd pad of base URL | Base URL moet eindigen op /v1 |
Een eenvoudige retry-wrapper neemt een paar regels in beslag en verwijdert een hele klasse van sporadische lege responsen:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key="YOUR_KEY")
def ask(messages, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(model="uncensored", messages=messages)
return r.choices[0].message.content or ""
except RateLimitError as e:
wait = 5
retry_after = getattr(e.response, "headers", {}).get("retry-after")
if retry_after:
wait = int(retry_after)
time.sleep(wait)
raise RuntimeError("still limited after retries")
Mislukte of geweigerde verzoeken worden niet in rekening gebracht, dus een retry-loop kost je niet twee keer. Je kunt dit bevestigen door X-Balance-USD te vergelijken voor en na een mislukte aanroep.
Oorzaak 5: het verkeerde endpoint, model of sleutel
Een korte checklist van configuratiefouten die vreemde resultaten opleveren in plaats van duidelijke fouten:
- De basis-URL is
https://api.unfilteredaiapi.com/v1. Een ontbrekende/v1of een verdubbeling kan een 404-antwoord opleveren dat een tolerant client omzet in een leeg antwoord. - De modelnaam is
uncensored, exact gespeld. Een model uit de catalogus van een andere provider instellen is een veelvoorkomende copy-paste fout. - Alleen
POST /v1/chat/completionsenGET /v1/modelsbestaan. De legacy endpoint voor voltooiingen, embeddings en afbeeldingsroutes zijn niet beschikbaar, dus een bibliotheek die ze aanroept krijgt niets nuttigs terug. - De sleutel wordt verzonden als een Bearer token en heeft geen overtollige spaties of aanhalingstekens uit een env-bestand.
Roep GET /v1/models aan met je sleutel als verbindingstest. Als het model wordt weergegeven, zijn de basis-URL en de sleutel correct en ligt het probleem in het verzoeklichaam. De quickstart bevat een werkend verzoek ter vergelijking, en de FAQ behandelt toegang, limieten en facturatie.
Logboek dat het volgende incident bekort
Lege antwoorden zijn moeilijk te debuggen achteraf omdat niemand heeft vastgelegd wat de server stuurde. Een paar regels logging veranderen een mysterie in een opzoekactie.
- Log de
X-Request-Idantwoordkop bij elke aanroep, succesvol of niet. - Log
finish_reason, deusageaantallen en de lengte van de teruggegeven tekst. - Voor streams log je hoeveel brokken aankwamen en hoeveel tekst bevatten. Nul brokken met tekst en een normale finish wijzen naar je parser. Nul brokken totaal wijst naar het netwerk of de proxy.
- Geef een waarschuwing bij de verhouding van lege antwoorden tot totale aanroepen, niet bij enkele gebeurtenissen. Een lege in de duizend is ruis. Vijf procent is een bug.
Wanneer je een falende aanroep vergelijkt met een werkende, diff dan eerst de verzoeklichamen. Een gewijzigd systeemprompt, een toegevoegde stop lijst, een kleinere max_tokens of een verwisselde modelnaam verklaart de meeste regressies. Zet het verzoeklichaam in de log voor een steekproef van aanroepen, na het verwijderen van persoonlijke gegevens.
Als meerdere gebruikers tegelijkertijd lege antwoorden rapporteren en je curl-test ook faalt, is de oorzaak waarschijnlijk niet je code. Controleer eerst op een 429 met Retry-After, omdat tijdelijke overbelasting zo wordt gemeld, en probeer opnieuw na de aangegeven vertraging. Als de curl-test werkt en je app faalt, werk dan vanaf de client kant met de bovenstaande secties.
Als het antwoord kort is in plaats van leeg
Soms is het symptoom een eenregelig antwoord waar je een pagina wilde. Dat is een prompting-probleem meer dan een transportprobleem. Vraag om de lengte en vorm die je wilt ("minimaal 400 woorden, in drie alinea's"), zet de instructie in het systeembericht, en verhoog temperature een beetje als het model beknopt is. Het model is afgestemd om te antwoorden zonder inhoudsweigeringen voor wettelijk volwassen gebruik, dus een kort antwoord is zelden een weigering; het is vaker een onder-gespecificeerd verzoek. Seksuele inhoud met minderjarigen is de enige harde limiet en wordt altijd geweigerd.
Nog steeds vastgelopen? Stuur ondersteuning de X-Request-Id van het falende antwoord, de geschatte tijd, en het verzoeklichaam zonder je sleutel. Dat laat iemand de exacte aanroep vinden. Als je nieuw bent bij de service, heeft de sleutelpagina het claimen van het proeftegoed, wat genoeg is voor tientallen aanroepen voor debugging.
Meer handleidingen
Vragen en antwoorden
Waarom is message.content null?
Meestal gaf het model tool_calls terug in plaats van tekst, of werd de stream verkeerd gelezen. Controleer finish_reason en tool_calls op het bericht voordat je het als een fout behandelt.
Kost een leeg antwoord geld?
Mislukte of geweigerde verzoeken worden niet in rekening gebracht. Als een aanroep succesvol was en tokens heeft opgeleverd, zie je gebruikscijfers, en X-Balance-USD in de headers toont jouw saldo.
Kan een volledig contextvenster leiden tot lege output?
Ja. Prompt en completion delen 100.000 tokens, dus een bijna volle geschiedenis laat weinig of geen ruimte over voor het antwoord. Knip of vat eerdere beurten samen.
Waarom toont mijn stream niets, en dan ineens alles?
Een proxy of CDN buffert waarschijnlijk het SSE-antwoord. Schakel de buffering uit voor die route, zodat de gegevensfragmenten doorgaan zoals ze aankomen.
Je sleutel is nog maar één formulier verwijderd
Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele configuratie.