FR ▾

unfilteredaiapi.comhttps://api.unfilteredaiapi.com/v1

Unfiltered AI

API LLM brute et sans censure pour les développeurs.

Unfiltered AIObtenir une clé API

Réponse API LLM vide ? Causes et solutions

Lorsqu'une erreur de réponse API LLM vide apparaît, le serveur a généralement répondu et la chaîne vide provient de la façon dont la réponse est lue. Voici une liste de contrôle, classée par fréquence d'apparition des causes.

Données circulant dans un tuyau de verre vers une bulle de parole vide, avec une lentille révélant une branche cachée

Points clés

  • Imprimez d'abord le JSON brut. La plupart des réponses vides sont un problème d'analyse syntaxique, pas une panne.
  • Vérifiez finish_reason : length, stop et tool_calls expliquent chacun un champ content vide.
  • Dans les flux, lisez delta.content de manière défensive et ignorez les blocs sans choix.
  • Un 429 ou un proxy qui met en mémoire tampon les événements envoyés par le serveur (SSE) peut ressembler à une réponse vide dans certains clients.

Commencez par examiner la réponse brute

Avant de modifier les paramètres, capturez exactement ce qui a été renvoyé. Les bibliothèques wrapper masquent la cause : un simple print(response.choices[0].message.content) affiche None ou une chaîne vide, que le corps de la réponse soit vide, contienne un appel de fonction, ait été tronqué par une limite de longueur ou n'ait jamais été reçu.

Utilisez curl pour qu'aucun code client ne gêne, et incluez les en-têtes avec -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."}]
  }'

Lisez trois éléments dans le résultat. D'abord, la ligne de statut : 200 signifie qu'une complétion a été produite, 429 signifie qu'une limite a été atteinte, une erreur d'authentification comme 401 pointe généralement vers la clé. Deuxièmement, choices[0].finish_reason. Troisièmement, les en-têtes de réponse, en particulier X-Request-Id (gardez-le si vous contactez support) et X-Balance-USD, qui indique si le compte a encore du crédit. Si cet appel curl renvoie du texte, le service fonctionne et le problème vient de votre client. S'il renvoie un corps d'erreur, vous avez déjà la cause.

Cause 1 : le message contient un appel d'outil, pas du texte

Si vous passez tools et que le modèle décide d'appeler un outil, le message de l'assistant a tool_calls et son content est null ou vide. Le code qui lit uniquement content voit une réponse vide. La solution est de vérifier les appels d'outils en premier, d'exécuter la fonction, d'ajouter le résultat en tant que message avec role: "tool", et d'appeler à nouveau l'API.

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)

Si vous n'aviez pas l'intention de proposer des outils, supprimez les champs tools et tool_choice. Une définition d'outil restante issue d'une expérience antérieure est une raison classique de texte vide.

Cause 2 : la réponse a été coupée ou n'a jamais commencé

finish_reason explique la plupart du reste.

  • length. La complétion a atteint un plafond de tokens. Vous avez peut-être défini max_tokens très bas, par exemple 1 ou 10. Le paramètre est facultatif ici, car la complétion peut utiliser tout ce qui reste de la fenêtre de 100 000 tokens, donc la solution la plus simple est de le supprimer. Si vous avez besoin d'un plafond, définissez-le avec une marge.
  • stop. Le modèle a terminé normalement, ou il a produit l'une de vos chaînes stop. Une séquence d'arrêt comme une nouvelle ligne arrête la réponse au premier saut de ligne, ce qui peut vous laisser sans rien si le modèle commence par une ligne vide. Supprimez ou assouplissez la séquence.
  • tool_calls. Voir la section précédente.

Le débordement de contexte est l'autre problème de longueur. La fenêtre est de 100 000 tokens, comptant le prompt et la complétion ensemble. Si un historique de chat a grandi pour presque le remplir, il reste presque aucune place pour répondre. Réduisez les anciens tours ou résumez-les. La page sur la mémoire de conversation et la longue fenêtre de contexte montre des moyens de garder l'historique sous contrôle. Un corps de requête ne peut également pas dépasser 8 Mo.

Un dernier petit piège : le mode JSON. Avec response_format défini sur json_object, incluez le mot JSON dans vos instructions et décrivez la forme que vous souhaitez. Une invite vague combinée au mode JSON produit une sortie mince ou triviale qui semble vide une fois que vous en extrayez une clé.

Cause 3 : le streaming est lu incorrectement

Le streaming sur SSE envoie de nombreux petits blocs. Tous les blocs ne transportent pas de texte. Le premier bloc a souvent seulement le rôle, le dernier bloc de contenu porte un finish_reason avec un delta vide, et le dernier bloc rapportant l'utilisation peut arriver avec une liste choices vide. Le code qui indexe choices[0] sur chaque bloc plantera, et le code qui traite un bloc sans texte comme la réponse entière n'imprimera rien.

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]")

Deux problèmes d'environnement ressemblent également à des flux vides. Un proxy inverse ou un CDN qui met en mémoire tampon les réponses retiendra tous les chunks jusqu'à la fin, de sorte qu'un navigateur ne verra rien pendant longtemps, puis tout d'un coup, ou qu'un timeout se déclenchera en premier. Désactivez la mise en mémoire tampon des réponses pour l'endpoint de streaming dans votre proxy. Et un flux occupe son slot de concurrence jusqu'à sa fin, donc les flux abandonnés (un onglet fermé, un close() manquant) finiront par épuiser vos 8 slots. La requête suivante recevra alors un 429 au lieu de texte. Pour un exemple complet de serveur, consultez le backend FastAPI avec streaming SSE.

Cause 4 : une erreur que votre client a avalée

Certaines bibliothèques HTTP retournent une chaîne vide pour un statut non-200 au lieu de lever une exception. Journalisez le code de statut et le corps pour chaque échec. Les cas qui comptent :

Statut ou codeSignificationQue faire
429, rate_limitedPlus de 300 requêtes par minute sur une clé complète (60 sur l'essai)Ralentissez, ajoutez une file d'attente
429, concurrencyPlus de 8 requêtes simultanées sur une clé complète (2 sur le compte d'essai)Limitez vos travailleurs
429 avec Retry-After: 5Surcharge temporaireAttendez 5 secondes et réessayez
401Généralement une clé manquante ou incorrecteVérifiez l'en-tête Authorization: Bearer
404Généralement un chemin ou une URL de base incorrectsL'URL de base doit se terminer par /v1

Un simple wrapper de réessai prend quelques lignes et élimine toute une classe de blancs sporadiques :

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")

Les requêtes échouées ou refusées ne sont pas facturées, donc une boucle de réessai ne vous coûte pas deux fois. Vous pouvez le confirmer en comparant X-Balance-USD avant et après un appel échoué.

Cause 5 : le mauvais endpoint, modèle ou clé

Une courte checklist des erreurs de configuration qui produisent des résultats étranges plutôt que des erreurs bruyantes :

  1. L'URL de base est https://api.unfilteredaiapi.com/v1. Un /v1 manquant ou doublé peut donner un corps 404 qu'un client tolérant transforme en une réponse vide.
  2. Le nom du modèle est uncensored, orthographié exactement. Définir un modèle issu du catalogue d'un autre fournisseur est une erreur courante de copier-coller.
  3. Seuls POST /v1/chat/completions et GET /v1/models existent. L'endpoint legacy de complétion, les embeddings et les routes d'images ne sont pas disponibles, donc une bibliothèque qui les appelle ne reçoit rien d'utile.
  4. La clé est envoyée en tant que jeton Bearer et ne contient pas d'espaces blancs ou de guillemets parasites provenant d'un fichier env.

Appelez GET /v1/models avec votre clé comme test de connectivité. S'il liste le modèle, l'URL de base et la clé sont corrects et le problème est dans le corps de la requête. Le guide de démarrage rapide contient la requête minimale fonctionnelle à comparer, et la FAQ couvre l'accès, les limites et la facturation.

La journalisation qui réduit le prochain incident

Les réponses vides sont difficiles à déboguer après coup car personne n'a enregistré ce que le serveur a envoyé. Quelques lignes de journalisation transforment un mystère en recherche.

  1. Journalisez l’en-tête de réponse X-Request-Id pour chaque appel, réussi ou non.
  2. Journalisez finish_reason, les compteurs usage et la longueur du texte retourné.
  3. Pour les flux, journalisez combien de blocs sont arrivés et combien contenaient du texte. Zéro bloc avec du texte et une fin normale pointent vers votre parser. Zéro bloc au total pointe vers le réseau ou le proxy.
  4. Alertez sur le ratio de réponses vides par rapport au nombre total d'appels, et non sur des événements isolés. Un blanc sur mille est du bruit. Cinq pour cent est un bug.

Lorsque vous comparez un appel échoué avec un appel fonctionnel, comparez d'abord le corps de la requête. Un prompt système modifié, une liste stop ajoutée, un max_tokens plus petit ou un nom de modèle échangé expliquent la plupart des régressions. Mettez le corps de la requête dans le journal pour un échantillon d'appels, après avoir supprimé toutes les données personnelles.

Si plusieurs utilisateurs signalent des réponses vides simultanément et que votre test curl échoue également, la cause n’est probablement pas votre code. Vérifiez d’abord une erreur 429 avec Retry-After, car une surcharge temporaire est signalée ainsi, puis réessayez après le délai indiqué. Si le test curl fonctionne mais que votre application échoue, analysez le problème côté client en vous appuyant sur les sections ci-dessus.

Si la réponse est courte plutôt que vide

Parfois, le symptôme est une réponse d'une ligne là où vous vouliez une page. C'est un problème de prompt plus qu'un problème de transport. Demandez la longueur et la forme que vous souhaitez ("au moins 400 mots, en trois paragraphes"), placez l'instruction dans le message système, et augmentez légèrement temperature si le modèle est sobre. Le modèle est optimisé pour répondre sans refus de contenu pour une utilisation adulte légale, donc une réponse courte est rarement un refus ; c'est plus souvent une requête sous-précisée. Le contenu sexuel impliquant des mineurs est la seule limite stricte et est toujours refusé.

Toujours bloqué ? Envoyez au support l'X-Request-Id de la réponse échouée, l'heure approximative et le corps de la requête sans votre clé. Cela permet à quelqu'un de trouver l'appel exact. Si vous êtes nouveau sur le service, la page Clé contient la demande de crédit d'essai, qui suffit pour des douzaines d'appels de débogage.

Questions et réponses

Pourquoi message.content est-il null ?

Le plus souvent, le modèle a retourné des tool_calls au lieu de texte, ou le stream a été lu incorrectement. Vérifiez finish_reason et tool_calls sur le message avant de le traiter comme une erreur.

Une réponse vide coûte-t-elle de l’argent ?

Les requêtes échouées ou refusées ne sont pas facturées. Si un appel a réussi et produit des tokens, vous verrez les compteurs d’utilisation, et l’en-tête X-Balance-USD dans les en-têtes indique votre solde.

Une fenêtre de contexte pleine peut-elle provoquer une sortie vide ?

Oui. Le prompt et la complétion partagent 100 000 tokens, donc un historique presque complet laisse peu ou pas de place pour la réponse. Réduisez ou résumez les tours précédents.

Pourquoi mon flux affiche-t-il rien, puis tout d’un coup ?

Un proxy ou un CDN met probablement en mémoire tampon la réponse SSE. Désactivez la mise en mémoire tampon pour cette route afin que les blocs passent au fur et à mesure de leur arrivée.

Votre clé est à une étape formulaire

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé APILire la documentation