Errores
Todos los errores usan el formato de OpenAI, así que los SDK lanzan sus excepciones habituales (las rutas de Anthropic usan el de Anthropic, consulta Rutas de Anthropic):
Para la forma exacta de cada petición y respuesta, con ejemplos en curl, Python y Node, consulta la Referencia de la API.
{ "error": { "message": "'temperature' must be between 0 and 2.", "type": "invalid_request_error", "param": "temperature", "code": "invalid_value" }}type es uno de invalid_request_error, permission_error, billing_error, rate_limit_error o server_error. param nombra el campo problemático cuando lo hay. La cabecera x-request-id va en todas las respuestas; cítala cuando escribas a soporte. Los mensajes de error están en inglés.
400: petición incorrecta
Section titled “400: petición incorrecta”| code | Significado |
|---|---|
invalid_json |
el cuerpo no es JSON válido o no se pudo leer |
no_model_allowed |
una petición auto cuyo acceso a modelos no le deja a auto ningún modelo que pueda usar. El mensaje dice qué nivel revisar: account (cuenta), organization (organización), project (proyecto) o key (key). Consulta Acceso a modelos |
missing_messages |
falta messages o está vacío (si falta model, es auto) |
too_many_messages, too_many_tools |
más de 4096 mensajes o 256 herramientas |
invalid_value |
un campo está fuera de rango o mal formado; param dice cuál (en chat completions, modalities con audio y sin texto; en /v1/audio/speech, un input por encima de 4,096 caracteres o un speed fuera de 0.25 a 4; en /v1/images/generations, n por encima de 4, un size que no es ANCHOxALTO, o un size o quality que el modelo nombrado no produce, un response_format distinto de b64_json o url, o url con stream) |
unsupported_parameter |
un campo que Zabio no implementa (style en /v1/images/generations; n mayor que 1, logprobs, prediction, el rol antiguo function, modalities o audio en la Responses API, que responde en texto, una parte de contenido distinta de text, image_url e input_audio); tools enviadas a un modelo que no puede recibirlas a través de Zabio (uno cuyo capabilities.tools es false en GET /v1/models, o gpt-6-astra con stop, un max_tokens menor que 16, tu propia key de OpenAI o en un lote; ver Herramientas en gpt-6-astra) |
invalid_image_url |
una imagen no se pudo descargar o no está permitida; consulta Chat completions |
invalid_video_url |
una URL de video no se pudo descargar, no está permitida, no sirve un MP4, MOV o WebM, o supera los 20 MB en un modelo que no descarga el video por sí mismo (envía un video más grande como file_id, o su URL a un modelo Qwen por nombre); consulta Chat completions |
unsupported_format |
el archivo enviado a /v1/audio/transcriptions no es un formato de audio que el endpoint acepte; consulta Audio |
missing_file |
/v1/audio/transcriptions sin una parte file |
unsupported_value |
un valor que ningún modelo puede servir: en /v1/audio/transcriptions un response_format para el que el modelo no devuelve marcas de tiempo (srt, vtt, verbose_json), un idioma que no sirve, o diarized_json; en /v1/audio/speech un response_format que el modelo no produce, una voice que no tiene, o un input más largo del que acepta; en chat completions y en la Responses API un input_audio.format distinto de wav o mp3; en chat completions una entrada de modalities distinta de text y audio, un audio.format distinto de wav, mp3, flac, opus, pcm16 y aac, un objeto de voz personalizada, o un audio.format o una audio.voice que el modelo nombrado no ofrece, o un audio.format en el que no hace streaming con stream: true (solo pcm16 en los modelos de OpenAI), consulta Chat completions; un video que no es MP4, MOV ni WebM, o un video que el proveedor del modelo nombrado no acepta (una URL de YouTube o un WebM fuera de los modelos Gemini, un video enviado como datos de más de 10 MB de base64 a un modelo Qwen); en /v1/images/generations un output_format, un fondo transparente o un stream que ningún modelo produce para la petición, o response_format url en un servidor sin las URL de imagen activadas; param indica cuál |
moderation_blocked |
el sistema de seguridad del proveedor rechazó un prompt de imagen o retuvo una imagen generada; el mensaje lleva las categorías del proveedor cuando nombra alguna y la fase (entrada o salida), nunca su texto; consulta Imágenes |
byok_key_invalid |
el proveedor rechazó la key propia de tu organización; actualízala en Facturación, keys de proveedor. Zabio nunca recurre a su propia key en ese caso |
upstream_invalid_request |
el proveedor rechazó la petición; el mensaje incluye el motivo del proveedor |
unsupported_for_model |
el modelo que nombraste no puede hacer lo que pide la petición; param nombra el campo (Jev, jev-1.14.0 o jev-1.13.0, solo responde preguntas tipadas desde un json_schema, nunca texto, herramientas, imágenes ni un stream; un modelo de transcripción, de voz o de imagen nombrado en un endpoint de chat, o un modelo de chat nombrado en un endpoint de audio o de imágenes; una parte input_audio enviada a un modelo sin audio_input, consulta Chat completions; una parte de imagen enviada a un modelo sin vision; una parte de video enviada a un modelo sin video_input, consulta Chat completions; la modalidad de audio enviada a un modelo sin audio_output o a auto, o un audio.id del asistente enviado a auto o a un modelo de otro proveedor, consulta Chat completions) |
context_length_exceeded |
la petición no cabe en la ventana de contexto del modelo que nombraste, ni en la de ningún modelo que auto pueda usar para ella. El mensaje da el tamaño de la petición en tokens (estimado a cuatro caracteres por token), el max_tokens contado y la ventana (con auto, la mayor que puede usar); param es messages, o input en la Responses API. Acorta la entrada, baja max_tokens o nombra un modelo con una ventana mayor: GET /v1/models da el zabio.capabilities.context_window de cada modelo. La misma petición enviada otra vez recibe la misma respuesta. Sin max_tokens en un modelo que nombraste solo cuenta la entrada, y una petición cercana a la ventana se envía al modelo; si el modelo la rechaza la respuesta es upstream_invalid_request. Con auto y sin max_tokens, un modelo solo cuenta cuando su ventana, menos el 5 por ciento que Zabio deja libre, deja al menos 4.096 tokens para la respuesta junto a la entrada (o toda la salida máxima del modelo, si es menor), y el mensaje lo dice cuando ningún modelo los deja. Los modelos de Anthropic aceptan una petición cuya entrada cabe y reciben como mucho la salida máxima del modelo, o el max_tokens que fijes; una respuesta que llega a la ventana termina con finish_reason length. Los modelos de DeepSeek y Together AI rechazan una petición cuya entrada más el límite de salida supera la ventana, así que cerca de la ventana Zabio les envía el espacio que la ventana deja junto a la entrada, y la respuesta puede ser más corta que el máximo del modelo; cuando quedan menos de 4.096 tokens de espacio, cuenta la salida máxima del modelo y la petición es demasiado larga para ese modelo. En todos los modelos salvo los de Anthropic, un max_tokens demasiado grande para la ventana se baja al espacio que la ventana deja, nunca por debajo de 4.096 tokens (o de tu propio valor, si es menor); con menos espacio que eso cuenta tal como lo fijaste. Una petición demasiado larga para el modelo que nombraste no se lleva a otro modelo, salvo en los modelos de Anthropic, DeepSeek y Together AI, donde un modelo del mismo proveedor con una ventana mayor la atiende cuando las reglas de respaldo de la key lo permiten; el 400 llega cuando ninguno la admite. En la Responses API una conversación guardada que ya no cabe recibe también este código; consulta Responses API |
conversation_mismatch, conversation_too_large |
Responses API; consulta Responses API |
401: autenticación
Section titled “401: autenticación”code: invalid_api_key cuando la key falta, es incorrecta o está revocada; el mensaje dice cuál. Las keys se envían como Authorization: Bearer zb_live_....
code: key_expired cuando ha pasado la caducidad de la key. El mensaje, en inglés como todos los de la API, dice cuándo caducó: "This API key expired on 2026-11-01 00:00 UTC. Create a new key or change its expiration in the web app." La caducidad de una key se fija al crearla o después en su panel de edición; quien la creó recibe un correo 7 días antes. Las respuestas en segundo plano y los lotes que la key dejó en cola antes de caducar terminan con el mismo código.
402: sin créditos
Section titled “402: sin créditos”{"error": {"message": "Your organization has no credits left. Add credits at zabio.ai/billing to continue.", "type": "billing_error", "code": "insufficient_credits"}}Se devuelve antes de cualquier trabajo con el proveedor, solo cuando un saldo cero significa que no hay servicio: la organización está configurada para detenerse al llegar a cero, o es la segunda organización de una persona, que no tiene plan Free. Cualquier otra organización en cero funciona con los límites de Free (consulta Facturación, “El plan Free”) y recibe los códigos free_tier_* de abajo. La cabecera x-zabio-balance-micros lleva el saldo. Un modelo con nombre servido con tu propia key de proveedor no se rechaza; auto sí, tengas las keys que tengas, porque el clasificador se ejecuta con la key de Zabio. Un lote o una response en segundo plano cuyo coste estimado supera el saldo disponible también se rechaza con este código. También una petición de chat o de Responses, una generación o edición de imágenes, una llamada de voz, una transcripción o una llamada de embeddings cuyo coste estimado no cabe en el saldo que queda tras las llamadas aún en curso: el mensaje indica la estimación, el saldo y la cantidad mínima que añadir (consulta Facturación, “Qué pasa al llegar a cero”).
403: no permitido
Section titled “403: no permitido”| code | Significado |
|---|---|
insufficient_scope |
la key no tiene el scope para este endpoint (chat, embeddings o conversations) |
web_search_disabled |
la petición pide búsqueda web y la key tiene la búsqueda web desactivada (el ajuste web_search de la key). Ver Búsqueda web |
organization_suspended |
la organización está suspendida |
conversations_closed |
las conversaciones guardadas están cerradas para esta organización |
free_tier_model |
la petición nombra un modelo que no está en la lista de modelos gratuitos mientras la organización funciona con los límites de Free. El mensaje es “Top up your account to unlock this model” con el enlace de recarga; auto sigue funcionando y elige entre los modelos gratuitos. GET /v1/models marca los modelos bloqueados con zabio.availability: locked |
free_tier_limit con param members o api_keys |
los topes de cuenta del plan Free, en la API del panel: un miembro y dos API keys hasta la primera recarga |
prompt_injection_blocked |
la acción de la protección contra prompt injection de la key es block (o la petición la pidió) y la protección encontró un patrón de injection en la petición. Nada llegó a un modelo y no se cobró nada. zabio.guard, junto al error, dice dónde; consulta AI Firewall |
ip_not_allowed |
la llamada llegó desde una dirección que las listas de direcciones IP permitidas y denegadas de la organización, del proyecto de la key o de la key rechazan. El mensaje, en inglés, nombra la dirección desde la que llegó la llamada y dónde se definen las listas: "The address 198.51.100.7 is not allowed for this API key. An owner or admin of the organization sets the address lists in the dashboard, under AI Firewall, Network Access." Si no se pudo leer la dirección, lo dice en su lugar. Nunca dice qué lista la rechazó. Nada llegó a un modelo y no se cobró nada. Reintentar desde la misma dirección da la misma respuesta; consulta Listas de direcciones IP permitidas y denegadas |
404: no encontrado
Section titled “404: no encontrado”model_not_found: el modelo no existe, o Zabio no lo ofrece por ahora (el mensaje nombra otro modelo que usar cuando lo hay), o un nivel del acceso a modelos de la key (la cuenta, la organización, el proyecto o la key) no lo permite; un modelo auto (auto o una de sus líneas) que un nivel desmarcó se rechaza igual. La Responses API añade previous_response_not_found, conversation_not_found y response_not_found.
410: retirado
Section titled “410: retirado”model_retired: la petición nombra un modelo pasada su fecha de retirada (ver Modelos); el mensaje dice la fecha y, cuando el proveedor nombró un modelo que lo sustituye, ese modelo, para que sepas cuál nombrar en su lugar. Zabio la rechaza antes de cualquier trabajo con el proveedor, así que no se factura nada, en todos los endpoints que reciben un modelo: chat completions, Responses, embeddings, voz, transcripciones, generación y edición de imágenes, vídeos y las líneas de un lote.
413: demasiado grande
Section titled “413: demasiado grande”payload_too_large: el cuerpo supera los 32 MB. media_too_large: el archivo de audio enviado a /v1/audio/transcriptions supera los 25 MB, o las partes input_audio de una petición de chat completions o de la Responses API superan lo que acepta el modelo (100 MB decodificados en los modelos Gemini, 20 MB en los demás), o sus videos superan los 100 MB en total, o un video enviado por URL a un modelo Qwen supera los 2 GB; comprímelo o divídelo. Una parte de video o una respuesta en audio en una línea de lote responde unsupported_value para la línea, y background: true con una parte de video responde 400 unsupported_parameter: Zabio no guarda videos para después.
Edición de imágenes y generación en segundo plano
Section titled “Edición de imágenes y generación en segundo plano”POST /v1/images/edits (consulta Imágenes): 400 missing_file sin archivo image[], missing_field sin lista images en JSON; 400 invalid_multipart o invalid_json cuando el cuerpo no es multipart ni JSON; 400 invalid_value para una imagen que no es png, jpeg ni webp, una máscara que no es png, más de 16 imágenes, o más imágenes de las que acepta el modelo nombrado, y en JSON para un image_url que no es una data URL en base64, un file_id que la key no puede leer o que no es ni un archivo user_data ni una imagen, un enlace de imagen modificado, cuya imagen se borró o que la key no puede leer, una generación en segundo plano que no se ha completado, o un zabio.index fuera de sus imágenes; 400 expired en JSON para un file_id cuyo archivo o generación ha caducado, o cuyas imágenes eran enlaces que vencieron a los 60 minutos, o un enlace de imagen en image_url que venció; 400 unsupported_value para una máscara en un modelo que no la acepta, zabio.background, o un image_url que es una dirección web distinta de un enlace de imagen hecho por Zabio (Zabio no la descarga); 400 unsupported_parameter para input_fidelity o markup, o cualquier cosa que no sea index en el objeto zabio de una imagen; 413 media_too_large para una imagen de más de 50 MB, un cuerpo de más de 100 MB, imágenes de entrada de más de 100 MB en total, o imágenes de entrada por encima del límite de unos 14 MB de un modelo de Google nombrado.
Generaciones en segundo plano (consulta Imágenes): 400 unsupported_value en zabio.background en el plan gratuito; 400 invalid_value en zabio.expires_after sin zabio.background, con otro anchor que created_at o por debajo de 3600 segundos, y en la lista para un limit, after o status fuera de sus valores; 402 insufficient_credits cuando la petición se pone en cola sin saldo, y como error de una generación cuyo saldo llegó a cero antes de ejecutarse (no se cobra nada); con crédito de prueba, también cuando el coste estimado de la petición supera lo que queda de la prueba, al ponerla en cola o al ejecutarse; 409 generation_in_progress en DELETE mientras la generación se ejecuta en el proveedor; 410 expired en GET de una generación completada cuyas imágenes se borraron o caducaron bajo la retención de la organización; 503 background_unavailable cuando el servidor no puede ejecutar generaciones en segundo plano. Una generación que falla lleva status: failed y un error con el código y el mensaje del fallo de una llamada directa.
Videos (consulta Videos): 400 invalid_value para seconds, size o resolution fuera de rango o que un modelo nombrado no hace, n mayor que 1, ni prompt ni input_reference, un zabio.last_frame sin input_reference, o una imagen que no es png, jpeg o webp; 400 unsupported_value cuando ningún modelo puede hacer el video pedido, cuando el modelo nombrado no parte de una imagen (o necesita una), no toma un último cuadro o siempre hace sonido, para una imagen dada como dirección web, y para un variant distinto de video; 402 insufficient_credits cuando el saldo no cubre la estimación del video; 404 video_not_ready en /content antes de que el video esté completado; 409 video_in_progress en DELETE mientras el video se hace; 410 expired en /content de un video borrado o caducado; 503 video_unavailable cuando el servidor no puede hacer videos. Un video que falla lleva status: failed y un error: moderation_blocked (se cobra lo que cobró el proveedor, cuando cobra un rechazo, y el mensaje dice cuánto), generation_interrupted (el servidor se reinició en mal momento; el mensaje dice si se devolvió un cargo), generation_timeout (no estaba listo tras seis horas; no se cobra nada), insufficient_credits (el saldo llegó a cero antes de empezar; no se cobra nada), storage_unavailable, internal_error (un error del lado de Zabio; cuando el video ya se había cobrado, el cargo se devuelve y el mensaje lo dice), o un código de fallo del proveedor de arriba. Un enlace de video (zabio.url) responde 404 not_found cuando caducó, se cambió o su video se borró.
La revisión del AI Firewall (consulta Revisión del AI Firewall): 400 invalid_value nombra el elemento o el campo que pasa un límite; en /v1/moderations, 400 unsupported_input nombra una imagen que nada leería (una dirección https, un formato que no sea una data URL PNG o JPEG, cualquier imagen sin la revisión con un modelo).
429: demasiadas peticiones
Section titled “429: demasiadas peticiones”Todos los 429 llevan una cabecera Retry-After con los segundos a esperar. Existen cuatro límites:
| code | Ámbito | Detalles |
|---|---|---|
rate_limit_exceeded |
API key | el cupo de peticiones por minuto o de tokens por minuto de la key está vacío. Por defecto: 600 peticiones y 200,000 tokens por minuto; se configura por key. El cupo de tokens se cobra por adelantado con la estimación de entrada más el presupuesto de salida, limitado a lo que el modelo servido puede producir, y se ajusta al uso real tras la llamada; un max_tokens muy por encima de lo que la tarea necesita puede agotar el límite antes de tiempo, así que ponlo cerca de lo que necesitas. Las cabeceras x-ratelimit-limit-*, x-ratelimit-remaining-* y x-ratelimit-reset-* para requests y tokens van en todas las respuestas |
quota_exceeded |
key o miembro (nivel de organización) | se alcanzó el límite de gasto de la key en su periodo (un día, una semana desde el lunes o un mes, desde las 00:00 UTC, o toda la vida de la key), o la cuota mensual del miembro que creó la key. El mensaje dice cuándo se reinicia, por ejemplo "This API key's spend limit of 5.00 USD has been reached. It resets on 2026-10-19 at 00:00 UTC.". Van las cabeceras x-zabio-quota-scope (key o member), x-zabio-quota-limit y x-zabio-quota-remaining |
ip_rate_limit_exceeded |
dirección del cliente | demasiadas peticiones desde una misma dirección, comprobado antes de la autenticación. Por defecto 300 por minuto. Las cabeceras x-ratelimit-*-ip solo van en el rechazo |
upstream_rate_limited |
proveedor | el proveedor está limitando y se agotaron todos los fallbacks |
free_tier_limit |
organización, con los límites de Free | se alcanzó uno de los límites de Free; param y la cabecera x-zabio-free-limit lo nombran: requests_per_day (100 peticiones correctas por día UTC; Retry-After es el tiempo hasta las 00:00 UTC), requests_per_minute (20), daily_cost (el límite diario de uso razonable; se reinicia a las 00:00 UTC), input_tokens (la petición tiene más de 16,000 tokens de entrada; sin Retry-After, envía una petición más corta) o max_tokens (un max_tokens explícito por encima de 2,000; bájalo o déjalo sin fijar). El mensaje dice qué límite, cuándo se reinicia y que una recarga quita todos los límites. Las cabeceras de límite de Free (x-ratelimit-*-requests-day y el cupo del minuto en x-ratelimit-*-requests) van en todas las respuestas Free, rechazos incluidos. Consulta Facturación |
rate_limit_exceeded, quota_exceeded y free_tier_limit usan type: rate_limit_error.
5xx: lado del servidor
Section titled “5xx: lado del servidor”| Estado | code | Significado |
|---|---|---|
| 500 | internal_error |
una condición inesperada; la causa nunca va en el cuerpo |
| 500 | guard_unavailable |
con la acción redact de la protección, la petición no se pudo reescribir; nada llegó a un modelo, reintenta la petición |
| 502 | upstream_error |
el proveedor devolvió un error o una respuesta ilegible tras los reintentos y fallbacks. Retry-After: 5 cuando tiene sentido reintentar |
| 503 | no_provider_available |
ahora mismo no hay ningún proveedor sano para esta petición; Retry-After: 5. Una petición demasiado larga para todos los modelos que puede usar recibe en su lugar 400 context_length_exceeded |
| 503 | vendor_unavailable |
la llamada nombró un modelo de un proveedor que ahora mismo no está disponible a través de Zabio; llama a otro modelo o a auto, o reintenta más tarde; Retry-After: 5 |
| 503 | auth_unavailable, billing_unavailable, conversations_unavailable |
una dependencia de Zabio no está disponible temporalmente |
| 503 | guard_unavailable |
POST /v1/guard/check o /v1/moderations no pudo ejecutarse ahora: los patrones están desactivados del lado de Zabio y la revisión con un modelo no se ejecutó; inténtalo más tarde, o pide la revisión con un modelo |
| 503 | web_search_unavailable |
la búsqueda web está desactivada del lado de Zabio en este momento; envía la petición sin ella, o inténtalo más tarde |
| 503 | free_tier_unavailable |
no se pudieron leer los contadores de los límites de Free, así que una llamada gratuita se rechaza en lugar de servirse sin medir; reintenta en breve. Las llamadas de pago no se ven afectadas. También es la respuesta de GET /v1/public/free-tier cuando la lista no se puede leer |
| 504 | upstream_timeout |
el proveedor no respondió a tiempo, o dejó de enviar datos; Retry-After: 5 |
| 504 | request_timeout |
la petición llegó al tiempo límite de Zabio sin ninguna respuesta: 20 minutos para una llamada sin streaming, 10 minutos hasta la primera parte de una respuesta en streaming. Si un intento con un proveedor falló antes del límite, recibes el error de ese intento. Un stream que ya empezó a enviar su respuesta nunca se corta por este límite. Una llamada que dura tanto ya tiene su 200 enviado (ver más abajo), así que el error suele llegar en el cuerpo o en el stream, no como estado 504 |
Rutas de Anthropic
Section titled “Rutas de Anthropic”POST /v1/messages, POST /v1/messages/count_tokens y GET /v1/models enviado con el header anthropic-version responden los errores con el envoltorio de Anthropic, para que los SDK de Anthropic lancen sus propias excepciones (consulta SDK de Anthropic y Claude Code). El mensaje es el de las tablas de arriba, y zabio.code es el código:
{"type": "error", "error": {"type": "rate_limit_error", "message": "Request rate limit reached for this API key. Retry after 2 seconds."}, "request_id": "req_6f1c...", "zabio": {"code": "rate_limit_exceeded"}}| Estado de Zabio | Estado en estas rutas | error.type |
|---|---|---|
| 400 | 400 | invalid_request_error |
| 401 | 401 | authentication_error |
| 402 | 402 | billing_error |
| 403 | 403 | permission_error |
| 404, 410 | 404 | not_found_error |
| 413 | 413 | request_too_large |
| 429 | 429 | rate_limit_error |
| 500, 502 | 500 | api_error |
| 503 | 529 | overloaded_error |
| 504 | 504 | timeout_error |
Tras un 200 ya confirmado (ver abajo), un mensaje sin streaming lleva este objeto como todo su cuerpo, y un stream termina con el evento error de Anthropic, event: error con el mismo objeto. El evento de error propio de un proveedor nunca se transmite.
Errores tras un 200 ya confirmado (llamadas largas)
Section titled “Errores tras un 200 ya confirmado (llamadas largas)”Para mantener vivas las llamadas largas, Zabio envía el estado 200 en cuanto un proveedor del modelo acepta la petición, o a los 90 segundos como muy tarde (ver “Llamadas largas” en las guías de chat completions y de Responses). Un fallo después de ese momento viaja en el cuerpo, con estado 200, así que un 200 puede llevar un error: comprueba si hay un objeto error antes de leer la respuesta.
| Llamada | Forma |
|---|---|
| chat completions, sin streaming | solo un objeto error, {"error": {"message", "type", "code", "request_id"}}, sin choices |
| chat completions, con streaming | data: {"error": {"message", "type", "code", "request_id"}}, después un último chunk con finish_reason: "error", y después data: [DONE] |
| Responses, sin streaming | el objeto response con status: "failed" y error: {"code", "message"} |
| Responses, con streaming | un evento response.failed con ese objeto |
Los valores de code son los mismos de las tablas anteriores. Los SDK de OpenAI devuelven un 200 sin streaming con un cuerpo de error sin lanzar una excepción, y la lanzan con el evento de error de un stream.
Errores de proveedor y fallback
Section titled “Errores de proveedor y fallback”Cuando un proveedor falla, Zabio reintenta con el siguiente modelo elegible según las reglas de enrutado (hasta 3 intentos; los modelos explícitos siguen zabio.fallback). Solo cuando se agotan todas las opciones ves un error de proveedor. El cuerpo del proveedor nunca te llega; x-zabio-vendor nombra al proveedor que falló y el mensaje incluye su motivo en los 400. El contenido que el proveedor se niega a producir vuelve como una respuesta normal con finish_reason: "content_filter", no como un error.
Durante el streaming, un fallo después de que el stream haya empezado se comunica como un objeto error dentro de un chunk seguido de un último chunk con finish_reason: "error" (chat completions) como un evento error (Responses API), o como un evento {"type":"error"} en lugar de speech.audio.done (voz con stream_format: sse), y el stream termina.
Dos códigos más en la Responses API
Section titled “Dos códigos más en la Responses API”missing_field(400): falta un campo obligatorio comoinput, o elrole,contentocall_idde un item. Si faltamodel, esauto.previous_response_not_foundyconversation_not_found(404) enPOST /v1/responses;response_not_found(404) aplica aGETyDELETE /v1/responses/{id}.
Enlaces de imagen
Section titled “Enlaces de imagen”Una imagen devuelta con response_format: url es un enlace a GET /v1/images/content/{file_id} que no necesita API key. Cuando ha caducado (60 minutos después de crearse la imagen), si se cambió cualquier parte del enlace, o cuando su imagen se borró, responde 404 not_found, exactamente como una ruta que no existe, así que un enlace nunca dice si una imagen existe. Un enlace no se puede renovar: descarga la imagen dentro de la hora.
La lista completa por endpoint está en la referencia de la API.