Lista prácticaHvoy AI5 min de lectura

Prueba de un gateway API con poco presupuesto: claves, factura y salida

Haz una aceptación reproducible: condiciones de parada, credenciales aisladas, tareas y reintentos, conciliación de cargos y ensayo de revocación y conexión alternativa.

Define la aceptación antes de recargar

Esta es una lista operativa en orden de ejecución, no una recomendación de gateways ni un artículo dependiente del ranking. Antes de enviar solicitudes, anota tarea, resultado correcto, espera aceptable, presupuesto total y condiciones de parada. Elige valores para tu trabajo. Una respuesta correcta o un precio promocional no son aceptación.

Usa tres resultados: aprobado, fallido y no probado. El contexto largo o las herramientas que no hayas ejercitado siguen sin probarse. Si es posible, elige una prueba pequeña de pago por uso. Si saldo o condiciones impiden controlarla, para en vez de hacer una recarga grande solo para terminar.

Aísla el entorno y crea una clave revocable

Crea un proyecto y una clave dedicados. Si se admite, limita presupuesto, frecuencia, origen y modelos, y comprueba si el límite solo avisa o rechaza solicitudes. Separa repositorios de prueba y producción; usa datos sintéticos, públicos o autorizados. No copies archivos de entorno productivos por comodidad ni pongas claves en repositorios, capturas, historiales compartidos o registros públicos.

Anota finalidad y ubicación de revocación de la clave, no la credencial completa. Si no existe el aislamiento necesario, reduce la prueba o para. No supongas que un tercero borrará tus datos. Lee las condiciones de conservación, transferencia, uso para entrenamiento y reembolso antes de enviar contenido.

Fija una base y una carga mínima

Registra versión del cliente, ID exacto del modelo, canal, parámetros, zona horaria y dirección documentada por el proveedor. Empieza con una petición mínima no sensible para verificar que tu programa interpreta la respuesta. Después usa tareas fijas: entrada corta, longitud habitual, máximo permitido por ti y un caso real de herramientas o salida estructurada si lo necesitas. No envíes peticiones mayores solo para completar casillas.

Define antes campos obligatorios, validación de argumentos, archivos modificables y criterio de finalización. Una respuesta fluida no demuestra corrección. Mantén tareas y parámetros iguales al comparar canales. Una diferencia aleatoria aislada no determina definitivamente la identidad del modelo.

Prueba streaming, herramientas y permisos por separado

Prueba primero una respuesta completa y después inicio, final e interrupción del consumidor de streaming, sin tratar texto parcial como terminado. Usa un entorno aislado o sustitutos de solo lectura para herramientas y valida argumentos antes de ejecutarlos. Los argumentos generados no son autorización. Comprueba que cancelar no deje reintentos en segundo plano.

Para escribir archivos o activar pagos, empieza sin efectos reales y conserva aprobación humana. Una petición API correcta no acredita toda una tarea de Claude Code, Codex u otro cliente. Recorre la tarea completa con la versión que desplegarás.

Ejercita errores y reintentos de forma limitada

Simula desconexión local, un tiempo de espera corto o cancelación solo en entornos donde tengas permiso; no hagas pruebas de carga al proveedor. Registra por separado autenticación fallida, límites de frecuencia, errores ascendentes, formato incorrecto y cancelación. Distingue respuestas del servidor de errores del cliente. Elimina cabeceras de autorización, claves, datos personales y contenido sensible de los registros.

Fija máximo de reintentos, espera progresiva y presupuesto total de tiempo. Respeta indicaciones de protocolo verificadas como Retry-After. No repitas a ciegas errores de autenticación o parámetros. Una escritura con tiempo agotado puede haberse completado: consulta el estado o usa idempotencia verificada, no ejecutes otra vez solo porque faltó respuesta.

Concilia consumo, saldo y coste de una tarea completada

Registra saldo y hora antes y después, conservando identificadores de solicitud sin secretos y el desglose disponible. Concilia entrada, salida, aciertos/escrituras de caché y cargos especiales por separado. Confirma moneda, unidad, nivel, multiplicadores y redondeo. No compares directamente precio por millón de tokens con precio por llamada ni anotes consumo ausente como coste cero.

En una tarea fija cuenta intentos, finalizaciones correctas, tiempo y cargos totales. Fallos, reintentos y salidas largas pueden anular una entrada barata. Si la contabilidad tarda, marca pendiente y revisa según el proveedor. Si la diferencia sigue sin explicación, no amplíes el uso y pide detalle; no asumas primero fraude ni que tus cálculos necesariamente están mal.

Repite a distintas horas sin generar carga

Repite la misma tarea a pequeña escala, registrando inicio, finalización, espera al primer fragmento y tiempo total: son latencias distintas. Unas pocas observaciones pueden revelar fallos intermitentes, pero no garantizan estabilidad duradera ni sustituyen un acuerdo de nivel de servicio.

Respeta concurrencia y frecuencia; no busques capacidad con un bucle ilimitado. Conserva categorías y contexto de fallos, no solo la mejor ejecución. Si cambian nivel de cuenta, versión o canal, vuelve a validar los criterios afectados. Un aprobado anterior solo vale bajo sus condiciones anteriores.

Ensaya realmente la revocación y una alternativa

Al terminar, revoca la clave dedicada y verifica con una petición mínima no sensible que ya no accede. Comprueba que la aplicación no siga cargando credenciales antiguas. Detén tareas en segundo plano, desactiva recargas automáticas o suscripciones no deseadas y gestiona el saldo restante según el proveedor. Registra cierres pendientes y contacta con soporte; no hay garantía de reembolso.

En aislamiento cambia a otra conexión ya probada y verifica asignación de modelos, estructura de salida, permisos y tarifas. No cambies y reenvíes sin control una escritura en curso. Un segundo canal no demuestra independencia de la infraestructura ascendente. Prepara también una pausa segura del trabajo.

Deja una decisión verificable y condiciones de parada

Conserva al menos ID de tarea, resultado esperado, versiones de cliente y modelo, canal, hora, resultado, latencia, intentos, consumo, cargo, error sin secretos y próxima acción. Guarda solo lo necesario; no publiques conversaciones sensibles originales como prueba. Asigna responsable o condición de revisión a cada punto no probado.

Considera aumentar el presupuesto gradualmente solo tras aprobar tareas críticas, explicar cargos, aislar permisos y confirmar una salida. Ante exposición de claves, efectos incontrolados, cargos inesperados o permisos inexplicables, para y revoca primero; después conserva evidencia sin secretos y pide ayuda. Esta lista reduce puntos ciegos, no garantiza autenticidad del modelo, compatibilidad ni seguridad financiera.

Recursos del sitio para revisar