Obtener uso de API Key

Devuelve el detalle de uso paginado para una API Key de usuario.

​

Resumen

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

​

Parámetros de consulta

Parámetro	Tipo	Valores por defecto / límites	Descripción
page	integer	valor por defecto 1, mínimo 1	Número de página empezando en 1
limit	integer	valor por defecto 50, mínimo 1, máximo 100	Tamaño de página
logicalModel	string	longitud máxima 100	Nombre del modelo lógico solicitado
modelVendor	string	longitud máxima 100	Proveedor público del modelo
scene	enum	-	chat, image, audio, video, embedding, rerank, translation, music, 3d
accessChannel	enum	-	platform o byok
startDate	string	-	Límite inferior inclusivo; acepta RFC3339 con zona horaria o YYYY-MM-DD
endDate	string	-	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.
• La metadata de routing interno y de canales físicos permanece oculta de forma intencional.
• Todos los campos monetarios siguen disponibles en USD y ahora también incluyen equivalentes de visualización en RMB, como cost_cny, total_cost_cny y cost_cny dentro de cada breakdown.
• api_key.exchange_rate es la tasa USD→CNY usada para todos los valores *_cny de esa respuesta.

​

Ejemplo

cURL

curl "https://api.lemondata.cc/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.