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
description: Use the Cloudflare billing to pay for and authenticate your inference requests.
9
10
---
10
11
11
-
:::caution
12
-
Unified Billing is in closed beta. Request for access.
13
-
:::
12
+
import { DashButton } from"~/components";
13
+
14
+
Unified Billing allows users to connect to various AI providers (such as OpenAI, Anthropic, and Google AI Studio) and receive a single Cloudflare bill. To use Unified Billing, you must purchase and load credits into your Cloudflare account in the Cloudflare dashboard, which you can then spend with AI Gateway.
15
+
16
+
## Pre-requisites
14
17
15
-
Unified Billing allows users to connect to various AI providers (e.g. OpenAI, Anthropic) and receive a single Cloudflare bill. To use Unified Billing, users must purchase and load credits into their Cloudflare account, via the Dashboard, which can then be spent via the AI Gateway.
18
+
- Ensure your Cloudflare account has [sufficient credits loaded](#load-credits).
19
+
- Ensure you have [authenticated](/ai-gateway/configuration/authentication/) your AI Gateway.
16
20
21
+
## Load credits
17
22
18
-
### Load credits
23
+
To load credits for AI Gateway:
19
24
20
-
- Navigate to [AI Gateway](https://dash.cloudflare.com/?to=/:account/ai/ai-gateway) on Cloudflare dashboard
21
-
- The "Credits Available" card on the top right shows how many AI gateway credits you have on your account currently.
22
-
- Click "Manage" to navigate to the new billing page
23
-
- If you don't have a payment method already on your account, you will be prompted to "Add a payment method to purchase credits" on top of page.
24
-
- Once you have a card added, you will be able to do a credit top up on your account by clicking "Top-up credits", and then adding the required amount on the next popup.
25
+
1. In the Cloudflare dashboard, go to the **AI Gateway** page.
25
26
27
+
<DashButtonurl="/?to=/:account/ai/ai-gateway" />
28
+
29
+
The **Credits Available** card on the top right shows how many AI gateway credits you have on your account currently.
30
+
31
+
2. In **Credits Available**, select **Manage**.
32
+
3. If your account does not have an available payment method, AI Gateway will prompt you to add a payment method to purchase credits. Add a payment method.
33
+
4. Select **Top-up credits**.
34
+
5. Add the amount of credits you want to purchase, then select **Confirm and pay**.
26
35
27
36
### Auto-top up
28
37
29
-
- Navigate to [AI Gateway](https://dash.cloudflare.com/?to=/:account/ai/ai-gateway) on Cloudflare dashboard
30
-
- Click "Manage" on the "Credits Available" card on the top right to navigate to the new billing page
31
-
- Click the "Setup auto top-up credits" option on the dashboard, and set up a threshold and a recharge amount for auto topup.
38
+
You can configure AI Gateway to automatically replenish your credits when they fall below a certain threshold. To configure auto top-up:
39
+
40
+
1. In the Cloudflare dashboard, go to the **AI Gateway** page.
32
41
33
-
When your balance falls below the given threshold, we will automatically apply the auto topup on your account.
42
+
<DashButtonurl="/?to=/:account/ai/ai-gateway" />
34
43
35
-
### Using Unified Billing
44
+
2. In **Credits Available**, select **Manage**.
45
+
3. Select **Setup auto top-up credits**.
46
+
4. Choose a threshold and a recharge amount for auto top-up.
36
47
37
-
#### Pre-requisites
48
+
When your balance falls below the set threshold, AI Gateway will automatically apply the auto top-up amount to your account.
38
49
39
-
- Ensure your gateway is [authenticated](/ai-gateway/configuration/authentication/).
50
+
## Use Unified Billing
40
51
41
-
Call any supported provider without passing any API Key. The request will automatically use Cloudflare's key and deduct credits from your account.
52
+
Call any supported provider without passing an API Key. The request will automatically use Cloudflare's key and deduct credits from your account.
42
53
43
-
Example with Unified API:
54
+
For example, you can use the Unified API:
44
55
45
56
```bash
46
57
curl -X POST https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/compat/chat/completions \
@@ -57,15 +68,16 @@ curl -X POST https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/comp
57
68
}'
58
69
```
59
70
60
-
### Spend limit
71
+
### Spend limits
61
72
62
73
Set spend limits to prevent unexpected charges on your loaded credits. You can define daily, weekly, or monthly limits. When a limit is reached, the AI Gateway automatically stops processing requests until the period resets or you increase the limit.
63
74
75
+
### Supported providers
64
76
65
-
### Supported Providers
77
+
Unified Billing supports the following AI providers:
Copy file name to clipboardExpand all lines: src/content/release-notes/ai-gateway.yaml
+58-2Lines changed: 58 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -3,14 +3,70 @@ link: "/ai-gateway/changelog/"
3
3
productName: AI Gateway
4
4
productLink: "/ai-gateway/"
5
5
entries:
6
+
# - publish_date: "2025-11-25"
7
+
# description: |-
8
+
# New easy to use [utility](/ai-gateway/integrations/utility/) for simplified AI Gateway integration. Drop `useAIGateway({ binding: env.AI })` anwhere in any worker project and AI requests will be automatically routed through AI Gateway.
9
+
- publish_date: "2025-11-21"
10
+
description: |-
11
+
Unified Billing now supports opt-in Zero Data Retention. This ensures supported upstream AI providers (eg [OpenAI ZDR](https://platform.openai.com/docs/guides/your-data#zero-data-retention)) do not retain request and response data.
12
+
- publish_date: "2025-11-14"
13
+
description: |-
14
+
- Supports adding OpenAI compatible [Custom Providers](/ai-gateway/configuration/custom/) for inferencing with AI providers that are not natively supported by AI Gateway
15
+
- Cost and usage tracking for voice models
16
+
- You can now use Workers AI via AI Gateway with no additional configuration. Previously, this required generating / passing additional Workers AI tokens.
17
+
- publish_date: "2025-11-06"
18
+
title: Unified Billing
19
+
description: |-
20
+
- [Unified Billing](/ai-gateway/features/unified-billing/) is now in open beta. Connect multiple AI providers (e.g. OpenAI, Anthropic) without any additional setup and pay through a single Cloudflare invoice. To use it, purchase credits in the Cloudflare Dashboard and spend them across providers via AI Gateway.
- Added cost tracking and observability support for async video generation requests for OpenAI Sora 2 and Google AI Studio Veo 3.
35
+
- `cf-aig-eventId` and `cf-aig-log-id` headers are now returned on all requests including failed requests
36
+
- publish_date: "2025-10-14"
37
+
description: The Model playground is now available in the AI Gateway Cloudflare Dashboard, allowing you to request and compare model behaviour across all models supported by AI Gateway.
38
+
- publish_date: "2025-10-07"
39
+
description: |-
40
+
- Add support for [Deepgram on Workers AI](/ai-gateway/usage/websockets-api/realtime-api/#deepgram-workers-ai) using Websocket transport.
41
+
- Added [Parallel](/ai-gateway/usage/providers/parallel/) as a provider.
42
+
- publish_date: "2025-09-24"
43
+
title: OTEL Tracing
44
+
description: |-
45
+
Added OpenTelemetry (OTEL) tracing export for better observability and debugging of AI Gateway requests.
46
+
47
+
- publish_date: "2025-09-21"
48
+
description: |-
49
+
- Added support for [Fal AI](/ai-gateway/usage/providers/fal/) provider.
50
+
- You can now set up custom Stripe usage reporting, and report usage and costs for your users directly to Stripe from AI Gateway.
51
+
- Fixed incorrectly geoblocked requests for certain regions.
52
+
53
+
- publish_date: "2025-09-19"
54
+
description: |-
55
+
- New API endpoint (`/compat/v1/models`) for listing available models along with their costs.
56
+
- Unified API now supports Google Vertex AI providers and all their models.
57
+
- BYOK support for requests using WebSocket transport.
58
+
- publish_date: "2025-08-28"
59
+
title: Data Loss Prevention
60
+
description: |-
61
+
[Data loss prevention](/ai-gateway/features/dlp/) capabilities are now available to scan both incoming prompts and outgoing AI responses for sensitive information, ensuring your AI applications maintain security and compliance standards.
6
62
- publish_date: "2025-08-25"
7
63
title: Dynamic routing
8
64
description: |-
9
-
Introduced [Dynamic routing](/ai-gateway/routing/dynamic-routing/) to help manage AI provider interactions effectively, ensuring your applications remain responsive and reliable.
65
+
Introduced [Dynamic routing](/ai-gateway/routing/dynamic-routing/) that lets you visually or via JSON define flexible request flows that segment users, enforce quotas, and choose models with fallbacks—without changing application code.
10
66
- publish_date: "2025-08-21"
11
67
title: Bring your own keys (BYOK)
12
68
description: |-
13
-
Introduced [Bring your own keys (BYOK)](/ai-gateway/configuration/byok/) allowing you to save your ai provider keys directly in the AI Gateway dashboard.
69
+
Introduced [Bring your own keys (BYOK)](/ai-gateway/configuration/bring-your-own-keys/) allowing you to save your AI provider keys securely with Cloudflare Secret Store and manage them through the Cloudflare dashboard.
0 commit comments