Saltar al contenido principal
DocumentaciónDevelopers

Uso y registros de solicitudes

Consulta el uso de tokens de tu organización y el registro de cada solicitud a través de la API de administración.

Menú de la documentación

El uso y los registros de solicitudes responden en el host de tu consola con la misma API key. El propietario de la API key necesita el permiso usage.read para toda la organización, o usage.read_own para sus propias solicitudes. La consola muestra los mismos datos en Usage y en Request logs.

Resumen de uso

export CCSIO_CONSOLE_URL="https://console.latam.ccsio.ai"

# Totals per model and per key for October (UTC; "to" is exclusive). Without from and to: the last 7 days.
curl "$CCSIO_CONSOLE_URL/metering/v1/usage/summary?from=2026-10-01T00:00:00Z&to=2026-11-01T00:00:00Z" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

El resumen agrupa el uso de la ventana de tiempo por modelo (models), por quién lo generó (by_principal) y por día UTC (series). Acótalo con model_alias, api_key_id, principal u operation_class (inference o tool).

Registros de solicitudes

Una entrada por solicitud, la más reciente primero, con su estado, su duración, el tiempo hasta el primer token, los tokens y quién la hizo. Filtra por model, api_key_id, team, session, operation o status, y pagina con cursor:

# One page of the request log, newest first. Pass next_cursor as cursor for the next page.
curl "$CCSIO_CONSOLE_URL/metering/v1/organizations/acme/request-logs?limit=50" \
  -H "Authorization: Bearer $CCSIO_API_KEY"
JSON
{
  "request_id": "req-01k7yqa2c4e6g8j0m2p4r6t8v0",
  "occurred_at": "2026-10-14T16:41:02Z",
  "operation": "chat",
  "http_status": 200,
  "outcome": "success",
  "error_code": null,
  "session_id": "sess-7f3a",
  "api_key_id": "01K7YQ4D8M2P6S9V3X5Z7B1C4F",
  "duration_ms": 1840,
  "ttft_ms": 212,
  "tokens": { "input": 412, "output": 697, "total": 1109 },
  "measurement": "measured",
  "measurement_reason": null,
  "quantities": [
    { "unit": "input_tokens", "amount": "412" },
    { "unit": "output_tokens", "amount": "697" }
  ],
  "end_user": {
    "principal_ref": "svc/01K7YP2C9W4X5E8H3J6M0N1Q2R",
    "principal_class": "service",
    "email": null,
    "display_name": "billing-app"
  },
  "team_id": "platform",
  "model": "qwen3.8-flash-next",
  "attempts": 1
}
Una entrada de request_logs.
Explora la plataforma

Obtén tu primera key API

El registro está abierto. Cuatro pasos hasta tu primera llamada: crea tu cuenta, crea tu organización, crea tu API key y empieza a usarla.

  1. 01Crea tu cuenta
  2. 02Crea tu organización
  3. 03Crea tu API key
  4. 04Empieza a usarla