You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 29ac358
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: src/content/docs/agents/inference/bring-your-own-api-key.mdx
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ import VideoEmbed from '@components/VideoEmbed.astro';
8
8
9
9
Warp supports **Bring Your Own API Key (BYOK)** for users who want to connect agents to their own Anthropic, OpenAI, or Google API accounts.
10
10
11
-
This lets you use your own API keys for model access, giving you control over model selection, billing, and data routing. See [Model Choice](/agents/inference/model-choice/) for a list of supported models. For xAI's Grok models, you connect a [SuperGrok subscription](/agents/inference/grok-subscription/) instead of adding an API key. For OpenAI models, you can add an API key or connect a [ChatGPT subscription](/agents/inference/chatgpt-subscription/).
11
+
This lets you use your own API keys for model access, giving you control over model selection, billing, and data routing. See [Model Choice](/agents/inference/model-choice/) for a list of supported models. For xAI's Grok models, you connect a [SuperGrok subscription](/agents/inference/grok-subscription/) instead of adding an API key. For eligible OpenAI models in Warp Agent conversations in the Warp app, you can add an API key or connect a [ChatGPT subscription](/agents/inference/chatgpt-subscription/).
12
12
13
13
BYOK provides greater flexibility in model access and ensures Warp **never consumes your**[AI credits](/support-and-community/plans-and-billing/credits/) for requests routed through your own keys.
14
14
@@ -30,7 +30,7 @@ Warp offers several ways to bring your own AI infrastructure. Use this table to
30
30
|**[Custom inference endpoint](/agents/inference/custom-inference-endpoint/)**| Connect Warp to an OpenAI-compatible endpoint such as OpenRouter, LiteLLM, z.ai, or an internal gateway. | Free and all eligible paid plans |
31
31
|**[Bring Your Own LLM](/enterprise/enterprise-features/bring-your-own-llm/)** (BYOLLM) | Enterprise-managed inference through your cloud provider (AWS Bedrock and Gemini Enterprise Agent Platform (Vertex AI) today; Azure Foundry coming soon), with Warp handling routing, orchestration, governance, and observability. | Enterprise only |
32
32
|**[SuperGrok subscription](/agents/inference/grok-subscription/)**| Connect your SuperGrok subscription to use Grok models through your xAI account. Tokens are stored locally on your device. | Free and all eligible paid plans |
33
-
|**[ChatGPT subscription](/agents/inference/chatgpt-subscription/)**| Connect your ChatGPT plan to use OpenAI models through your OpenAI account. The connection is held for your Warp account on Warp's backend. | Plans that allow member-provided keys |
33
+
|**[ChatGPT subscription](/agents/inference/chatgpt-subscription/)**| Connect your ChatGPT plan to use eligible OpenAI models in Warp Agent conversations in the Warp app. | Plans that allow member-provided keys |
34
34
35
35
See [Warp pricing](https://www.warp.dev/pricing) for current plan availability.
36
36
@@ -161,6 +161,6 @@ Enterprise teams can also configure **team-managed API keys** centrally: an admi
161
161
*[Custom inference endpoint](/agents/inference/custom-inference-endpoint/) — Route Warp through any OpenAI-compatible endpoint, such as OpenRouter, LiteLLM, z.ai, or an internal gateway.
162
162
*[Bring Your Own LLM](/enterprise/enterprise-features/bring-your-own-llm/) — Enterprise-managed inference through your cloud provider or approved infrastructure.
163
163
*[SuperGrok subscription](/agents/inference/grok-subscription/) — Use Grok models through your xAI account instead of Warp credits.
164
-
*[ChatGPT subscription](/agents/inference/chatgpt-subscription/) — Use OpenAI models through your ChatGPT plan instead of Warp credits.
164
+
*[ChatGPT subscription](/agents/inference/chatgpt-subscription/) — Use eligible OpenAI models in Warp Agent conversations in the Warp app through your ChatGPT plan.
165
165
*[Model Choice](/agents/inference/model-choice/) — Full list of supported models and `model_id` values.
166
166
*[Credits](/support-and-community/plans-and-billing/credits/) — How Warp credits work and when they're consumed.
Copy file name to clipboardExpand all lines: src/content/docs/agents/inference/chatgpt-subscription.mdx
+21-26Lines changed: 21 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,76 +1,71 @@
1
1
---
2
-
title: ChatGPT subscription
2
+
title: Connecting a ChatGPT subscription
3
3
description: >-
4
-
Connect your ChatGPT plan to run OpenAI models in Warp through your OpenAI
5
-
account instead of spending Warp credits.
4
+
Connect a ChatGPT plan to use eligible OpenAI models in Warp Agent
5
+
conversations in the Warp app without spending Warp credits.
6
6
sidebar:
7
7
label: "ChatGPT subscription"
8
8
---
9
9
10
-
Warp lets you connect your **ChatGPT plan**so OpenAI models run through your own OpenAI account. If you already pay for ChatGPT, you can use OpenAI models in Warp without spending your Warp [credits](/support-and-community/plans-and-billing/credits/). OpenAI determines which plan tiers are eligible and how much usage they include.
10
+
Warp lets you connect your **ChatGPT plan**to use eligible OpenAI models in Warp Agent conversations in the Warp app. Requests that use the connected plan count against its OpenAI usage limits instead of spending your Warp [credits](/support-and-community/plans-and-billing/credits/).
11
11
12
-
Connecting a plan works like [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), except you sign in to your OpenAI account instead of pasting an API key. It covers OpenAI models only — Anthropic, Google, and xAI models are unaffected.
12
+
Connecting a plan works like [Bring Your Own API Key (BYOK)](/agents/inference/bring-your-own-api-key/), except you sign in to your OpenAI account instead of pasting an API key. The connection covers eligible OpenAI models only. Warp does not support connecting a Claude subscription, and Anthropic, Google, and xAI models are unaffected.
13
13
14
14
:::note
15
15
Like BYOK, connecting a ChatGPT plan requires that your team allows members to bring their own keys. See [Warp pricing](https://www.warp.dev/pricing) for current availability.
16
16
:::
17
17
18
18
## How it works
19
19
20
-
When you connect your plan, Warp opens your browser to OpenAI's Sign in with ChatGPT consent screen. Approving it links your ChatGPT account to your Warp account and authorizes OpenAI to share a delegated credential with Warp. Unlike a BYOK API key or a [SuperGrok subscription](/agents/inference/grok-subscription/), that credential is held for your account by Warp's backend rather than in your device's keychain, so you connect once per Warp account rather than once per device.
20
+
When you connect your plan, Warp opens your browser to OpenAI's Sign in with ChatGPT consent screen. Approving the connection links your ChatGPT account to your Warp account and authorizes OpenAI to share a delegated credential with Warp. Unlike a BYOK API key or a [SuperGrok subscription](/agents/inference/grok-subscription/), Warp stores that credential for your Warp account rather than in your device's keychain.
21
21
22
-
With a plan connected, Warp attaches the delegated credential to OpenAI requests the Warp Agent makes on your behalf, and OpenAI bills them to your ChatGPT plan. A pasted OpenAI API key takes precedence: if you have both, the key wins and the plan goes unused.
22
+
With a plan connected, eligible OpenAI requests from the Warp Agent count against your ChatGPT plan. A pasted OpenAI API key takes precedence if you have both.
23
23
24
-
Connecting also changes which models you see. The server recomputes your model catalog when the connection starts or stops, and OpenAI models that your Warp plan would otherwise gate behind an upgrade become selectable, since you are paying OpenAI for them directly.
24
+
Connecting can make additional eligible OpenAI models selectable in the model picker. OpenAI determines which plan tiers, models, and capabilities are eligible.
25
25
26
26
### What OpenAI sees
27
27
28
-
Each subscription-billed request carries two fixed labels that OpenAI requires: an activity name and a short purpose string, such as "Generate the agent's next response in a Warp agent conversation." The labels are fixed per request type and never derived from your prompt. OpenAI stores them separately from the request content and can surface them in your ChatGPT usage settings.
28
+
Warp sends OpenAI fixed activity and purpose labels with each request that uses your connected plan. The labels describe the request type, are not derived from your prompt, and may appear in your [ChatGPT usage settings](https://chatgpt.com/settings/usage).
29
29
30
-
Agent turns are not the only requests that carry them. Background work the agent does for you — generating a conversation title, compacting earlier history to free context-window space, condensing a large tool result — is also billed to your plan and labeled the same way.
30
+
Supporting requests in the same conversation, such as generating a title or compacting conversation history, can also count against your plan.
31
31
32
32
:::caution
33
33
Data retention on OpenAI's side is governed by your own OpenAI account and its terms. Warp's Zero Data Retention agreements cover Warp-managed inference, so they do not apply to requests billed to your plan. See [Zero Data Retention and BYOK](/agents/inference/bring-your-own-api-key/#zero-data-retention-zdr-and-byok).
34
34
:::
35
35
36
36
## Connecting your ChatGPT plan
37
37
38
-
1. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** and find the "Use OpenAI ChatGPT plan" row under **Custom Inference**.
39
-
2. Click **Continue with ChatGPT**. Warp opens your browser and shows a toast confirming the attempt. Click **Cancel** in Warp if you want to abandon it.
40
-
3. Approve the connection in your browser. Back in Warp, the row shows a green check with "Connected as YOUR_EMAIL on DATE," where YOUR_EMAIL is the address on your ChatGPT account.
38
+
1. In the Warp app, go to **Settings** > **Agents** > **Warp Agent** and find the "Use your OpenAI ChatGPT plan" row under "Custom Inference."
39
+
2. Click **Continue with ChatGPT**. Warp opens the OpenAI consent screen in your browser. Click **Cancel** in Warp to abandon the attempt.
40
+
3. Approve the connection in your browser. Back in Warp, the row shows "Connected as YOUR_EMAIL on DATE," where YOUR_EMAIL is the address on your ChatGPT account.
41
41
4. Select an OpenAI model from the model picker in your prompt input. Connecting a plan doesn't change your selected model, so this step is what actually routes requests through your plan.
42
42
43
-
The first time a connected plan funds a request, Warp shows a one-time notice titled "You're using your ChatGPT plan" with a **Manage usage**button that opens your [ChatGPT usage settings](https://chatgpt.com/settings/usage). OpenAI's Sign in with ChatGPT guidelines require it.
43
+
The first time an eligible request uses the connected plan, Warp shows "You're using your ChatGPT plan." Click **Manage usage**to open your [ChatGPT usage settings](https://chatgpt.com/settings/usage).
44
44
45
45
If the row shows "Reconnect to use your plan for requests" next to the connected timestamp, the link still exists but OpenAI is no longer sharing a credential. Disconnect and connect again.
46
46
47
-
Connecting is only available in the Warp app. The [Warp Agent CLI](/agents/cli/) has no equivalent command, unlike `/connect-grok` for a SuperGrok subscription.
48
47
49
48
## Usage and billing behavior
50
49
51
50
When an OpenAI model runs on your connected plan:
52
51
53
52
* Warp **does not consume** any of your [credits](/support-and-community/plans-and-billing/credits/) for the request.
54
-
*Inference is billed to your ChatGPT plan, within OpenAI's usage limits for that plan.
53
+
*The request counts against your ChatGPT plan, within OpenAI's usage limits for that plan.
55
54
* Review and manage that usage in your [ChatGPT usage settings](https://chatgpt.com/settings/usage), not in Warp. The **Billing and Usage** settings page links out to the same place.
56
55
57
56
### When OpenAI refuses a request
58
57
59
-
OpenAI can reject a subscription-billed request — for example, when your plan runs out of shared usage. Warp surfaces OpenAI's own message along with the recovery options OpenAI offers, which can include:
58
+
OpenAI can reject a subscription-billed request, for example when your plan reaches its usage limit. Depending on the error, Warp may offer **Try again**, **Manage ChatGPT usage**, or **Continue with Warp credits**.
60
59
61
-
***Retry** - Send the turn again, still billed to your plan.
62
-
***Continue with Warp credits** - Switch the rest of this conversation to Warp-funded inference and resume. This applies to that conversation only; new conversations go back to using your plan.
63
-
* A link to an OpenAI page, such as your usage settings.
64
-
65
-
Choosing **Continue with Warp credits** is one-way for that conversation. Later failures in it are shown as a short disclosure line rather than an error, because the conversation is no longer using your plan.
60
+
Choosing **Continue with Warp credits** switches the rest of that conversation to Warp-funded inference. New conversations return to using your plan.
66
61
67
62
### Auto models
68
63
69
64
Warp's **Auto** models always use Warp's own inference and **always consume Warp credits**, even with a ChatGPT plan connected. To use your plan, select a specific OpenAI model from the model picker.
70
65
71
66
## Disconnecting
72
67
73
-
In the Warp app, go to **Settings** > **Agents** > **Warp Agent**, find the "Use OpenAI ChatGPT plan" row, and click **Disconnect**. Warp unlinks the account on its servers, and OpenAI models go back to running on Warp credits. Connecting again re-shows the one-time plan notice.
68
+
In the Warp app, go to **Settings** > **Agents** > **Warp Agent**, find the "Use your OpenAI ChatGPT plan" row, and click **Disconnect**. Warp unlinks the account on its servers, and eligible OpenAI requests return to using Warp credits.
74
69
75
70
## Troubleshooting
76
71
@@ -80,11 +75,11 @@ Each ChatGPT account links to one Warp account, and each Warp account links to o
80
75
81
76
### "Verify the email on your ChatGPT account, then try again"
82
77
83
-
OpenAI refuses to share a plan from an account with an unverified email. Verify it with OpenAI and retry.
78
+
Verify the email with OpenAI, then click **Continue with ChatGPT** again.
84
79
85
-
### "Your browser is signed in to a different ChatGPT account"
80
+
### "Your browser is signed in to a different Warp account"
86
81
87
-
The browser completed the flow as an account other than the one you intended. Sign out of ChatGPT in your browser, or use a private window, then click **Continue with ChatGPT** again.
82
+
The Warp account signed in to your browser does not match the Warp account that started the connection. Sign in to the same Warp account in your browser, then click **Continue with ChatGPT** again.
0 commit comments