OpenAI

The OpenAI connector imports organization-level usage and costs from the OpenAI platform.

It reads two feeds from the OpenAI Admin API:

  • The bill — what you were actually charged, broken down by project and model. Dashboard spend comes from the bill.
  • The usage log — how many tokens each user and API key consumed. Token counts and the per-user/per-key breakdown come from this.

OpenAI's bill shows the total charged per project, model and day, but not which user or API key was responsible — Cloud Ctrl shares each day's charge across the users and keys that were active, so heavier users carry more of the cost. Shares always add back up to exactly what OpenAI billed, so your total spend matches your OpenAI invoice.

Get an Admin API key

  1. Sign in to the OpenAI platform as an organization Owner (or a user with a usage-read role).
  2. Open Settings → Organization → Admin keys — also reachable from the menu under your avatar at the bottom-left of the screen.
  3. Create a new Admin key (it starts with sk-admin-) with the api.usage.read scope so Cloud Ctrl can read the organization Usage and Costs APIs.
  4. Copy the key — it is only shown once.

Warning

Project keys (sk-proj-…) and standard keys (sk-…) cannot read the organization Usage and Costs APIs — only an Admin key works.

Add a Credential

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

Add a Cloud Account

  1. From Settings → Cloud Connections → OpenAI, click + Add Cloud Account
  2. Select the credential you just added
  3. Optionally enter an Organization ID (org-…) — the Admin key is already scoped to a single organization, so this is only needed if the key has access to multiple organizations
  4. Click Submit

Once connected, the initial import pulls up to 90 days of history (configurable on the cloud account), then imports month by month. Your data can take up to 24 hours to complete the initial import.

Attribution notes

  • Spend by project — to see spend by project, make your API calls within an OpenAI Project (use project-scoped API keys). Calls not tied to a project show as unattributed. If all your spend shows as unattributed by project, this is the fix.
  • Cost centre and repository — OpenAI does not provide these. Use Tag Mapping to map your OpenAI projects to the cost centres or repositories you use elsewhere in Cloud Ctrl.
  • Credits and free trials — when credits fully cover a day's usage, OpenAI's bill shows $0 for that day and Cloud Ctrl shows $0 too. Token counts are still recorded, but no cost appears because nothing was billed. Your Net AI Spend always matches your OpenAI bill.
  • Seat costs — OpenAI bills purely on usage today, so there is no per-seat subscription to split.