Diagnóstico y recuperación
Resuelve envíos inciertos, conflictos de cotización, problemas de archivos y flujos interrumpidos.
Conserva pruebas útiles
Anota hora, endpoint, estado HTTP, code de negocio, request_id y cualquier taskId recibido. Distingue un rechazo explícito, la falta de respuesta de red y un fallo posterior a la aceptación. No adjuntes claves API, prompts completos ni archivos originales a registros generales o consultas de soporte.
El modelo no aparece o no está disponible
Actualiza el catálogo autenticado y comprueba enabled, available y el ID exacto del modelo de la tarea. Una página pública no demuestra que tu cuenta pueda invocarlo. Si persiste 50301, revisa la disponibilidad y limita los intentos. Repetir solicitudes no habilita un modelo.
Entrada inválida o conflicto de cotización
Para 400, comprueba tipos, valores y requisitos condicionales con el inputSchema actual y elimina parámetros no admitidos. Para 40901, solicita y confirma una nueva cotización: cambió la entrada, la vigencia o el precio. El 409 ordinario depende de la operación. Una clave vinculada a otro contenido requiere corregir la asociación de negocio.
Tiempo agotado sin ID de tarea
Conserva el contenido y el Idempotency-Key originales. Recupera el mismo envío dentro del plazo válido antes de crear otro. Cuando tengas taskId, consulta recordInfo. Un timeout, cerrar la pestaña o desconectar el flujo no cancela tareas aceptadas; comprueba state, cost y settled.
La carga termina pero el archivo se rechaza
Después de PUT debes llamar a files/{fileId}/commit. Usa el URI spicy:// recibido en un campo admitido por el modelo, nunca uploadUrl. Verifica Content-Type firmado, tamaño, formato, cuenta y caducidad. Los archivos de entrada se conservan un día; un reintento puede exigir otra carga y actualizar la entrada.
No llega el callback o caducó la descarga
Revisa el receptor HTTPS, la firma sobre los bytes originales y una respuesta positiva rápida. Recupera el estado con recordInfo y elimina duplicados antes de procesar el evento. Si el resultado sigue almacenado, pide otro enlace. Reintenta pending más tarde; unavailable o un resultado caducado no se recuperan actualizando la URL anterior.
El flujo termina antes de tiempo
Comprueba HTTP y Content-Type antes de interpretar SSE del protocolo elegido. Los fragmentos TCP no son eventos completos y cerrar la conexión no confirma éxito. Revisa eventos finales, errores y plazos de tu aplicación. No supongas devolución ni reenvío gratuito tras desconectar; conserva request_id y consulta el uso.
Saldo, límites y soporte
Para 40201 revisa el saldo disponible; para 40202 los topes de cuenta y clave; para 429 respeta Retry-After y reduce la frecuencia. Nunca envíes claves al soporte. Comparte pasos, hora, IDs, estructura de campos sin datos sensibles y resultados esperado y real.
Guías relacionadas
Errores y reintentos · Idempotencia · Carga y descarga de medios · Texto y streaming