aisplice

Referencia de la API

Antes de salir a producción

Usa esta lista antes de recibir tráfico de producción. Reúne la seguridad de las claves, los reintentos, la durabilidad de las tareas asíncronas, la observabilidad y la facturación en un único control previo al lanzamiento.

#Lista de verificación para producción

Seguridad

  • Guarda las claves de API en servidores de confianza; nunca incluyas una clave permanente en un navegador o en un binario móvil.
  • Usa una clave con alcance limitado por proyecto y configura límites de modelos, IP, RPM, RPD y cuota.
  • Rota las claves sin cambiar el código de integración con los modelos.

Fiabilidad

  • Define timeouts de conexión y de respuesta en cada solicitud.
  • Respeta Retry-After y usa backoff exponencial con jitter.
  • Usa Idempotency-Key en los envíos asíncronos facturables y guarda task_id.

Observabilidad

  • Registra el ID de solicitud, el modelo, el endpoint, la latencia, el estado HTTP y el task_id.
  • Mantén el contenido de los prompts fuera de los logs, salvo que la depuración esté activada explícitamente.
  • Vincula los fallos visibles para el cliente con la fila correspondiente del registro de solicitudes.

Control de costos

  • Lee los precios y las opciones admitidas de los metadatos de los modelos en vivo.
  • Define topes de cuota por proyecto y avisa antes de que se agote la billetera.
  • Concilia con el consumo final de seis decimales del Registro de solicitudes.

#Control previo al lanzamiento

  1. 1

    Prueba la solicitud mínima

    Ejecuta el modelo y el endpoint exactos en Workbench y luego copia la solicitud generada.

  2. 2

    Prueba los casos de fallo

    Verifica el manejo de 401, 402, 429, timeouts, archivos multimedia no válidos y fallos finales de tareas.

  3. 3

    Verifica la facturación

    Relaciona una solicitud exitosa con su consumo de seis decimales y su ID de solicitud.

  4. 4

    Activa la monitorización

    Configura alertas de tasa de errores, latencia, tareas atascadas, fallos de webhook y saldo bajo.

#Accesos directos operativos

Gestionar clavesRevisar el uso y el registro de solicitudesVer billeteraVer el estado de la plataforma

¿Sigues con el problema?

Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.

AnteriorAPIs heredadas y compatibilidadSiguienteChat Completions