OpenRouter

The OpenRouter connector imports account activity and costs from OpenRouter's activity analytics: spend and tokens per model and per upstream provider.

Get a Management key

The connector authenticates with an OpenRouter management key. A regular inference API key (used for chat completions) will be rejected with a 403 — management keys use the same sk-or-v1- prefix as inference keys but are created on a separate page, so it's easy to mix them up.

  1. Sign in to OpenRouter as an account admin.
  2. Open Settings → Management keys.
  3. Create a management key.
  4. Copy the key — it is only shown once.

Add a Credential

  1. Open Settings → Cloud Connections → OpenRouter
  2. Click + Add Credential
  3. Enter a display name and paste the management key
  4. Click Submit

Add a Cloud Account

  1. From Settings → Cloud Connections → OpenRouter, click + Add Cloud Account
  2. Select the credential you just added
  3. Optionally enter an Account ID — a stable label for the OpenRouter account/org the key is scoped to, used to group all imported rows under one account
  4. Click Submit

Attribution notes

  • Aggregated provider — OpenRouter routes requests to multiple underlying model providers. Each activity row identifies the upstream provider (e.g. OpenAI, Anthropic, Together) that served the request, so spend and tokens are available per model and per provider.
  • Account-level attribution — the activity endpoint returns account-wide usage aggregated by day, model and upstream provider. It does not break down by user, API key or project. To attribute spend by application or team, create a separate OpenRouter account (and Cloud Ctrl connection) for each, so each connection's spend is attributed at the account level.
  • 30-day retention — OpenRouter only retains the last 30 completed UTC days of activity, so imports run daily to avoid gaps. Backfilling beyond 30 days is not possible — any day not imported while inside the window cannot be recovered later. Keep the connection active.
  • OpenRouter bills in USD; Cloud Ctrl converts it to your display currency.