OpenAI

Learn how to connect your OpenAI organization to North as a Cost Loop.

Connect your OpenAI Cost Loop integration with your North account to see usage costs across the various models OpenAPI provides.

North reads your organization-wide OpenAI usage and spend through the OpenAI Admin API. One organization-scoped Admin key covers your whole organization.

Before You Start

You need administrator access to your OpenAI organization, and your OpenAI organization ID. Find the ID in the OpenAI platform under Settings, then Organization, then General. It starts with org-.

Connect OpenAI

1

Open the connect screen

Open Settings, then Integrations, then Add accounts. Under Cost Loops, select OpenAI.

2

Create an Admin key

In the OpenAI platform, open Settings, then Organization, then Admin keys. Then:

1. Click Create admin key.
2. Name it north. The name is optional.
3. Set the expiration to Never.
4. Open the Permissions tab and toggle Read on the Usage API scope.
5. Click Create admin key.

Set the expiration to Never. If the key expires, North stops receiving your usage and cost data until you supply a new one.

3

Enter your connection details

Fill in the fields:

• Connection name. A label to recognize this account by. It becomes the card title on your homepage.
• OpenAI organization ID. The org- value from your General settings.
• Admin API key. The key you just created.

4

Verify and connect

Click Verify & Connect. North checks the key against the organization ID before it saves the connection.

What North Reads

North reads a cost report and a set of usage reports.

Report	Frequency	Broken down by
Cost	Daily	Project, line item, API key
Usage	Hourly	Varies by endpoint. See below.

North reads usage from ten endpoints: completions, embeddings, moderations, images, audio speeches, audio transcriptions, vector stores, code interpreter sessions, file search calls, and web search calls.

Most of them break down by project, user, API key, and model. Two do not carry a model breakdown: vector stores and code interpreter sessions report by project only.

Cost is daily, and usage is hourly. That is a property of the OpenAI Admin API, which does not accept an hourly bucket on the cost endpoint.

After You Connect

OpenAI spend appears on your homepage as a card carrying your connection name. See Viewing Cost Loop Data for where else it shows up and at what detail.