|
| 1 | +--- |
| 2 | +title: Workers AI and AI Gateway unify model access and billing |
| 3 | +description: Call Workers AI and third-party models through shared APIs, observability, and prepaid billing. |
| 4 | +products: |
| 5 | + - ai-gateway |
| 6 | + - workers-ai |
| 7 | +date: 2026-08-07 |
| 8 | +--- |
| 9 | + |
| 10 | +import { TypeScriptExample } from "~/components"; |
| 11 | + |
| 12 | +Workers AI and AI Gateway now provide a unified path for accessing models and managing inference traffic. Use the same AI binding and REST API to call models hosted on Workers AI or by supported third-party providers, with AI Gateway providing observability, logging, caching, security, and billing controls. |
| 13 | + |
| 14 | +## Unified entrypoints and observability |
| 15 | + |
| 16 | +The [AI binding](/ai-gateway/usage/worker-binding-methods/) supports both Workers AI and third-party models through `env.AI.run()`. The [REST API](/ai-gateway/usage/rest-api/) provides shared `/ai/` endpoints with Cloudflare authentication across providers. |
| 17 | + |
| 18 | +Route a Workers AI request through AI Gateway by specifying a gateway ID. Use `default` to automatically create a gateway on the first authenticated request, or specify an existing gateway to separate applications and workloads: |
| 19 | + |
| 20 | +<TypeScriptExample> |
| 21 | + |
| 22 | +```ts |
| 23 | +const response = await env.AI.run( |
| 24 | + "@cf/zai-org/glm-5.2", |
| 25 | + { |
| 26 | + messages: [{ role: "user", content: "What is the capital of France?" }], |
| 27 | + }, |
| 28 | + { |
| 29 | + gateway: { id: "default" }, |
| 30 | + }, |
| 31 | +); |
| 32 | +``` |
| 33 | + |
| 34 | +</TypeScriptExample> |
| 35 | + |
| 36 | +Requests routed through AI Gateway can be logged and included in analytics for request volume, errors, latency, token usage, and costs. You can also configure controls such as caching, rate limiting, and request retries on the gateway. |
| 37 | + |
| 38 | +## Unified billing and higher rate limits |
| 39 | + |
| 40 | +You can now use prepaid [AI Gateway credits](/ai-gateway/features/unified-billing/) to pay for Workers AI inference. This provides one credit balance for Workers AI and supported third-party model providers. To use credits for Workers AI, set the gateway's [Workers AI billing setting](/ai-gateway/configuration/manage-gateway/#configure-workers-ai-billing) to **Unified billing**. Workers AI requests routed through that gateway deduct from your credit balance in real time. |
| 41 | + |
| 42 | +Prepaid credits also provide access to the following Workers AI frontier models without requiring the Workers Paid plan. Each frontier Workers AI model has a rate limit of 50 requests per minute per account, per model when billed with AI Gateway credits, compared to 20 requests per minute through standard Workers AI billing: |
| 43 | + |
| 44 | +- [`@cf/moonshotai/kimi-k2.6`](/workers-ai/models/kimi-k2.6/) |
| 45 | +- [`@cf/moonshotai/kimi-k2.7-code`](/workers-ai/models/kimi-k2.7-code/) |
| 46 | +- [`@cf/zai-org/glm-5.2`](/workers-ai/models/glm-5.2/) |
| 47 | + |
| 48 | +These limits are designed for typical agentic and coding workloads, where requests to frontier models can take longer to complete. |
| 49 | + |
| 50 | +For details, refer to [Workers AI limits](/workers-ai/platform/limits/), [Workers AI pricing](/workers-ai/platform/pricing/), [Unified Billing](/ai-gateway/features/unified-billing/), and the [AI Gateway model catalog](/ai/models/). |
0 commit comments