ES ▾

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

Unfiltered AI

API de LLM sin censura y sin procesar para desarrolladores.

Unfiltered AIObtener clave de API

¿Respuesta vacía de la API LLM? Causas y soluciones

Cuando aparece un error de respuesta vacía de la API LLM, el servidor suele haber respondido y la cadena vacía proviene de cómo se lee la respuesta. Aquí tienes una lista de verificación, ordenada por la frecuencia con la que aparece cada causa.

Datos fluyendo por una tubería de vidrio hacia una burbuja de discurso vacía, con una lente que revela una rama oculta

Puntos clave

  • Imprime primero el JSON en crudo. La mayoría de las respuestas vacías son un problema de parseo, no un fallo del servicio.
  • Comprueba finish_reason: length, stop y tool_calls explican cada uno un campo content en blanco.
  • En streams, lee delta.content de forma defensiva y omite los fragmentos sin choices.
  • Un 429 o un proxy que bufferice SSE puede parecer una respuesta vacía en algunos clientes.

Empieza por mirar la respuesta cruda

Antes de cambiar cualquier configuración, captura exactamente lo que devolvió. Las bibliotecas wrapper ocultan la causa: un simple print(response.choices[0].message.content) muestra None o una cadena vacía si el cuerpo estaba vacío, contenía una llamada a función, terminó por un límite de longitud o nunca llegó.

Usa curl para que ningún código del cliente estorbe, e incluye los encabezados con -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."}]
  }'

Lee tres cosas en el resultado. Primero, la línea de estado: 200 significa que se produjo un completado, 429 significa que se alcanzó un límite, un error de autenticación como 401 suele apuntar a la clave. Segundo, choices[0].finish_reason. Tercero, los encabezados de respuesta, especialmente X-Request-Id (guárdalo si contactas a soporte) y X-Balance-USD, que muestra si la cuenta aún tiene crédito. Si esta llamada curl devuelve texto, el servicio funciona y el problema está en tu cliente. Si devuelve un cuerpo de error, ya tienes la causa.

Causa 1: el mensaje contiene una llamada a función, no texto

Si pasas tools y el modelo decide llamar a uno, el mensaje del asistente tiene tool_calls y su content es null o vacío. El código que solo lee content ve una respuesta en blanco. La solución es comprobar las tool calls primero, ejecutar la función, añadir el resultado como un mensaje con role: "tool" y llamar a la API de nuevo.

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 no querías ofrecer herramientas, elimina los campos tools y tool_choice. Una definición de herramienta restante de un experimento anterior es una razón clásica para texto en blanco.

Causa 2: la respuesta se cortó o nunca comenzó

finish_reason explica la mayoría del resto.

  • length. El completado alcanzó un límite de tokens. Es posible que hayas establecido max_tokens muy bajo, como 1 o 10. El parámetro es opcional aquí, ya que el completado puede usar lo que quede de la ventana de 100.000 tokens, así que la solución más simple es eliminarlo. Si necesitas un límite, establécelo con margen.
  • stop. El modelo terminó normalmente, o produjo una de tus secuencias stop. Una secuencia de parada como un salto de línea detiene la respuesta en el primer salto de línea, lo que puede dejarte sin nada si el modelo comienza con una línea en blanco. Elimina o afloja la secuencia.
  • tool_calls. Consulta la sección anterior.

El desbordamiento de contexto es el otro problema de longitud. La ventana es de 100.000 tokens, contando prompt y completado juntos. Si un historial de chat ha crecido hasta llenarlo casi, queda casi ningún espacio para responder. Recorta turnos antiguos o resúmelos. La página sobre memoria de conversación y la ventana de contexto largo muestra formas de mantener el historial bajo control. También, el cuerpo de una petición no puede exceder 8 MB.

Una trampa más pequeña: modo JSON. Con response_format establecido en json_object, incluye la palabra JSON en tus instrucciones y describe la forma que deseas. Un prompt vago más el modo JSON produce una salida fina o trivial que parece vacía una vez que extraes una clave de ella.

Causa 3: el streaming se lee incorrectamente

El streaming sobre SSE envía muchos fragmentos pequeños. No todos los fragmentos llevan texto. El primer fragmento suele tener solo el rol, el último fragmento de contenido lleva un finish_reason con un delta vacío, y el fragmento final que reporta el uso puede llegar con una lista choices vacía. El código que indexa choices[0] en cada fragmento se bloqueará, y el código que trata un fragmento sin texto como la respuesta completa imprimirá nada.

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

Dos problemas de entorno también parecen flujos vacíos. Un proxy inverso o una CDN que almacena en búfer las respuestas retendrá todos los fragmentos hasta el final, así que un navegador no verá nada durante mucho tiempo y luego todo de golpe, o se activará un tiempo de espera primero. Desactiva el almacenamiento en búfer de respuestas para la ruta de streaming en tu proxy. Y un flujo ocupa su ranura de concurrencia hasta que termina, así que flujos abandonados (una pestaña cerrada, un close() faltante) consumirán gradualmente tus 8 ranuras. La siguiente petición obtendrá un 429 en lugar de texto. Para un ejemplo completo del servidor, consulta el backend de FastAPI con streaming SSE.

Causa 4: un error que tu cliente absorbió

Algunos wrappers HTTP devuelven una cadena vacía en un estado distinto a 200 en lugar de generar una excepción. Registra el código de estado y el cuerpo para cada fallo. Los casos que importan:

Estado o códigoSignificadoQué hacer
429, rate_limitedMás de 300 peticiones por minuto con una clave completa (60 en prueba)Ralentiza, añade una cola
429, concurrencyMás de 8 peticiones a la vez con una clave completa (2 en prueba)Limita tus trabajadores
429 con Retry-After: 5Sobrecarga temporalEspera 5 segundos y reintenta
401Típicamente una clave faltante o incorrectaComprueba el encabezado Authorization: Bearer
404Típicamente una ruta o URL base incorrectaLa URL base debe terminar en /v1

Un envoltorio de reintento simple toma unas pocas líneas y elimina toda una clase de respuestas en blanco esporádicas:

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

Las peticiones fallidas o rechazadas no se cobran, por lo que un bucle de reintento no te cuesta el doble. Puedes verificarlo comparando X-Balance-USD antes y después de una llamada fallida.

Causa 5: el endpoint, el modelo o la clave incorrectos

Una lista de verificación corta de errores de configuración que producen resultados extraños en lugar de errores ruidosos:

  1. La URL base es https://api.unfilteredaiapi.com/v1. La ausencia de /v1 o su duplicación puede devolver un cuerpo 404 que un cliente permisivo convierte en una respuesta vacía.
  2. El nombre del modelo es uncensored, escrito con la ortografía exacta. Establecer un modelo del catálogo de otro proveedor es un error común de copiar y pegar.
  3. Solo existen POST /v1/chat/completions y GET /v1/models. El endpoint de completions legacy, embeddings y rutas de imágenes no están disponibles, así que una biblioteca que los llama no obtiene nada útil.
  4. La clave se envía como token Bearer y no tiene espacios en blanco extraños ni comillas de un archivo de entorno.

Llama a GET /v1/models con tu clave como prueba de conectividad. Si enumera el modelo, la URL base y la clave son correctas y el problema está en el cuerpo de la petición. El inicio rápido tiene la petición mínima funcional para comparar, y el FAQ cubre acceso, límites y facturación.

Registro que acorta el próximo incidente

Las respuestas vacías son difíciles de depurar a posteriori porque nadie registró lo que envió el servidor. Unas pocas líneas de registro convierten un misterio en una consulta.

  1. Registra el encabezado de respuesta X-Request-Id con cada llamada, sea exitosa o no.
  2. Registra finish_reason, los conteos de usage y la longitud del texto devuelto.
  3. Para flujos, registra cuántos fragmentos llegaron y cuántos llevaban texto. Cero fragmentos con texto y una finalización normal apuntan a tu analizador. Cero fragmentos en absoluto apuntan a la red o al proxy.
  4. Alerta sobre la proporción de respuestas vacías respecto al total de llamadas, no sobre eventos individuales. Una respuesta vacía en mil es ruido. Cinco por ciento es un error.

Cuando comparas una llamada fallida con una que funciona, diferencia los cuerpos de la petición primero. Un prompt del sistema cambiado, una lista stop añadida, un max_tokens menor o un nombre de modelo intercambiado explica la mayoría de las regresiones. Pon el cuerpo de la petición en el registro para una muestra de llamadas, después de eliminar cualquier dato personal.

Si varios usuarios reportan respuestas vacías al mismo tiempo y tu prueba con curl también falla, la causa probablemente no sea tu código. Busca primero un 429 con Retry-After, ya que la sobrecarga temporal se indica de esa manera, y reintenta después del retraso indicado. Si la prueba con curl funciona y tu aplicación falla, trabaja desde el lado del cliente usando las secciones anteriores.

Si la respuesta es corta en lugar de vacía

A veces el síntoma es una respuesta de una línea donde querías una página. Eso es un problema de prompt más que de transporte. Pide la longitud y forma que deseas ("al menos 400 palabras, en tres párrafos"), pon la instrucción en el system message, y sube un poco temperature si el modelo es escueto. El modelo está ajustado para responder sin filtros de contenido para uso adulto legal, así que una respuesta corta rara vez es una negativa; es más probable una petición poco especificada. El contenido sexual que involucra a menores es el límite estricto y siempre se rechaza.

¿Sigues atascado? Envía al soporte el X-Request-Id de la respuesta fallida, la hora aproximada y el cuerpo de la petición sin tu clave. Eso permite a alguien encontrar la llamada exacta. Si eres nuevo en el servicio, la página de claves tiene la reclamación de crédito de prueba, que es suficiente para docenas de llamadas de depuración.

Preguntas y respuestas

¿Por qué message.content es null?

Lo más probable es que el modelo haya devuelto tool_calls en lugar de texto, o que el streaming se haya leído incorrectamente. Verifica finish_reason y tool_calls en el mensaje antes de tratarlo como un error.

¿Una respuesta vacía cuesta dinero?

Las solicitudes fallidas o rechazadas no se cobran. Si una llamada tuvo éxito y generó tokens, verás los conteos de uso, y X-Balance-USD en los encabezados muestra tu saldo.

¿Puede una ventana de contexto completa causar salida en blanco?

Sí. El prompt y el completado comparten 100.000 tokens, así que un historial casi lleno deja poco o ningún espacio para la respuesta. Recorta o resume turnos anteriores.

¿Por qué mi stream no muestra nada, y luego todo a la vez?

Un proxy o CDN probablemente está almacenando en búfer la respuesta SSE. Desactiva el almacenamiento en búfer para esa ruta para que los fragmentos pasen a medida que llegan.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de APILeer la documentación