Preguntas frecuentes sobre la API

Errores 401, modelo no encontrado, tiempos de espera, 429, respuestas truncadas: síntomas y soluciones.

Preguntas frecuentes sobre llamadas a la API. Busca tu síntoma y sigue los enlaces para ver los detalles.

¿Recibes 401 Unauthorized?

Clave incorrecta: comprueba que usas la clave completa guardada al crearla (la entrada enmascarada de la lista no es la clave completa);
Clave eliminada o caducada: confirma su estado en la página «Claves de API» y vuelve a crearla si hace falta;
Cabecera mal formada: el protocolo compatible con OpenAI espera Authorization: Bearer <key>; no omitas el prefijo Bearer ;
Más información en Autenticación.

¿«Model not found»?

ID de modelo mal escrito: copia el ID exacto del catálogo de modelos en lugar de escribirlo;
El modelo no existe en la plataforma o no está disponible en este momento: comprueba que la tarjeta existe y está disponible en el catálogo.

¿Tiempos de espera agotados o respuestas lentas?

Las solicitudes de contexto largo o salida larga son intrínsecamente más lentas; comprueba si max_tokens está innecesariamente alto;
Configura tiempos de espera y reintentos razonables en el cliente, con retroceso exponencial;
Para interfaces interactivas usa "stream": true: los primeros bytes llegan antes y la latencia percibida baja.

¿Muchos 429?

Estás alcanzando los límites de peticiones. Reduce la concurrencia y añade intervalos de retroceso; si la carga alta se mantiene, contacta con la plataforma para hablar de cuotas. Consulta Códigos de error.

¿Respuestas vacías o truncadas?

finish_reason es length: la respuesta alcanzó el tope de max_tokens; súbelo;
Comprueba que ninguna entrada de messages lleva un content vacío;
Algunos modelos restringen los formatos de entrada (por ejemplo, requisitos de la modalidad de imagen); consulta las notas de la tarjeta del modelo.

¿Cómo confirmo que una llamada se ha realizado correctamente?

Dos puntos de control: HTTP 200 con choices / usage en la respuesta, y el registro correspondiente (con el uso de tokens y el coste) en la página de Registros de la consola. Cuando ambos coinciden, el circuito está sano.