Connecting to OpenAI

Connect your OpenAI account to CloudZero to bring your OpenAI API cost and usage data into a unified view of all your cloud and SaaS spend. CloudZero organizes your OpenAI costs, along with your other costs, into categories (called Dimensions) that matter most to your business. For example: business unit, team, product, feature, environment, customer, or virtually anything else. Once connected and organized, you can quickly answer questions about your spend that matter to your stakeholders.

This guide covers creating a read-only Admin API key in the OpenAI Platform and configuring the connection in CloudZero. CloudZero uses OpenAI's Usage API to ingest your data. The connection is read-only.

What you need

  • CloudZero user with admin permissions
  • An OpenAI Admin API key (requires the Organization Owner role)
  • Your OpenAI Organization ID

Step 1: Create a read-only Admin API key in OpenAI

For full details on Admin API keys, see OpenAI's Admin API Keys documentation.

  1. Sign in to the OpenAI Platform and navigate to Admin Keys.
  2. Select + Create new Admin Key and give it a descriptive name (for example, "CloudZero Integration").
  3. Set the permissions to Restricted and grant Read access to the Management API and Usage API scopes.
  4. Select Create Admin Key.
  5. Copy the key and store it securely. OpenAI does not display the key again after creation.
ℹ️

Only Organization Owners can create Admin API keys. For details on roles, see OpenAI's Administration overview.

Step 2: Configure the connection in CloudZero

  1. In CloudZero, go to Settings > Cloud Connections.
  2. Select Create Connection +.
  3. Select the OpenAI tile.
  4. Enter a Connection Name. This label identifies the connection throughout CloudZero.
  5. Enter your Organization ID. You can find this in the OpenAI Platform under Settings > Organization.
  6. Enter the Admin API key you created in Step 1.
  7. Select Create Connection. You are redirected to Cloud Connections, where your new connection is listed.
OpenAI connection detail page showing connection name, Organization ID, and Admin API Key fields

What to expect

After you connect, CloudZero begins ingesting your OpenAI cost and usage data. Your OpenAI costs appear in Explorer and Analytics within 24 hours.

From there, your OpenAI costs work like any other cost data in CloudZero. For example, you can organize them by team or product using Dimensions, track trends in Dashboards, set Budgets, or ask questions in the AI Hub.

ℹ️

Have questions or feedback? Reach out to your account manager.