Saltar al contenido principal

Resumen

Este endpoint devuelve el detalle de uso por API Key sin exponer metadata de routing físico.

Parámetros de consulta

ParámetroTipoValores por defecto / límitesDescripción
pageintegervalor por defecto 1, mínimo 1Número de página empezando en 1
limitintegervalor por defecto 50, mínimo 1, máximo 100Tamaño de página
logicalModelstringlongitud máxima 100Nombre del modelo lógico solicitado
modelVendorstringlongitud máxima 100Proveedor público del modelo
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannelenum-platform o byok
startDatestring-Límite inferior inclusivo; acepta RFC3339 con zona horaria o YYYY-MM-DD
endDatestring-Límite superior inclusivo; acepta RFC3339 con zona horaria o YYYY-MM-DD
Si startDate y endDate se envían a la vez, startDate debe ser anterior o igual a endDate.

Notas

  • La respuesta está paginada.
  • La respuesta solo incluye campos públicos de facturación y reporting.
  • Cada registro de uso también puede incluir billing_transaction_id una vez que la solicitud subyacente haya quedado liquidada. Úsalo junto con request_id para la conciliación a nivel de solicitud.
  • La metadata de routing interno y de canales físicos permanece oculta de forma intencional.

Ejemplo

curl "https://api.aisonar.dev/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video&accessChannel=platform&startDate=2026-03-01&endDate=2026-03-31" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitud / Respuesta

Consulta el panel interactivo de OpenAPI de arriba para ver el esquema exacto y los campos de la respuesta.