yangmao.ai · Python setup money page

Cloudflare Workers AI Python API Setup

Use this page when you need a working Python starting point for Cloudflare Workers AI, then validate quota and model names in the official console before production.

Quick verdict

  • Free API: 每天 10000 神经元(永久有效)
  • Rate limits: 10000 requests/day
  • Best model starting point: @cf/meta/llama-3.1-8b-instruct
  • China access: direct or relatively friendly

Provider fit matrix

Best fit Image generation prototypes, creative automation, and media workflows
Watch out Image/video credits can burn faster than chat tokens; test with small batches first
Production fallback Keep at least one compatible backup provider before shipping

Production readiness checklist

Quota gate Start inside 每天 10000 神经元(永久有效); log usage before adding retries or batch jobs.
No-card check Try the free path first, then confirm whether billing is required for API keys, higher RPM, or production endpoints.
Regional smoke test Still run one request from your deployment region and from China if users are there.
Source freshness Snapshot date: 2026-05-16; official quota and pricing can change without notice.

Python setup snapshot

Start with the smallest possible embeddings request, then move the key to your server-side secret manager before production.

# 方式一:通过 AI Gateway(OpenAI 兼容)
from openai import OpenAI

client = OpenAI(
    api_key="your-cloudflare-api-token",
    base_url="https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}"
)

response = client.chat.completions.create(
    model="@cf/meta/llama-3.1-8b-instruct",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

# 方式二:REST API
import requests

response = requests.post(
    f"https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/@cf/meta/llama-3.1-8b-instruct",
    headers={"Authorization": "Bearer your-api-token"},
    json={"messages": [{"role": "user", "content": "Hello!"}]}
)
print(response.json())

Free API and pricing notes

每天 10000 神经元(永久有效)

Cloudflare Workers $5/mo plan includes Workers AI with 10,000 free neurons/day. 50+ open-source models available including LLM, image generation (SD XL), embeddings, speech-to-text. OpenAI-compatible API via AI Gateway, or direct Workers AI binding. Inference runs on Cloudflare's global edge network with ultra-low latency. Direct China access.

Access and production risk

China-friendly / direct path likely

Direct access from China via Cloudflare edge network, low latency. Workers AI accelerated by global CDN.

How to set it up

1

Create or locate your provider API key in the official dashboard.

2

Install the OpenAI-compatible Python SDK or the provider-supported SDK.

3

Set the API key in an environment variable instead of hard-coding secrets.

4

Run a small Cloudflare Workers AI embeddings request with @cf/meta/llama-3.1-8b-instruct.

5

Watch free credits, RPM/TPM limits, response shape, and error messages before scaling.

Fallback CTA with tracked UTM

If you do not want to juggle provider keys, rate limits, and regional access, use openllmapi.com as a unified API fallback.

Try openllmapi with one key →

UTM: utm_source=yangmao.ai · utm_medium=seo · utm_campaign=provider · utm_content=cloudflare-workers-ai-setup-python

Related internal links

Source snapshot

Data source: yangmao.ai provider YAML tracker plus provider docs reviewed by the daily crawler. Official dashboards can change quota and pricing without notice; verify before production.

yangmao.ai provider id
cloudflare-workers-ai
Official source
https://ai.cloudflare.com
Last updated
2026-05-16
Free tier
10,000 free requests/day
API credits
每天 10000 神经元(永久有效)
Rate limit
10000 requests/day
Access note
Direct access from China via Cloudflare edge network, low latency. Workers AI accelerated by global CDN.

FAQ

Does Cloudflare Workers AI have a free API?

Yes. Current yangmao.ai record: 每天 10000 神经元(永久有效). Rate limit note: 10000 requests/day.

Is Cloudflare Workers AI OpenAI-compatible?

The recorded setup uses an OpenAI-compatible pattern or SDK-style call. Validate the latest base URL and model names in Cloudflare Workers AI docs.

Can I use Cloudflare Workers AI from China?

Cloudflare Workers AI is marked as relatively direct or China-friendly in the current tracker.

What should I do when Cloudflare Workers AI credits run out?

Compare the alternatives below, check /en/free-ai-api/, or use the openllmapi CTA on this page as a one-key fallback with tracked UTM: campaign=provider, content=cloudflare-workers-ai-setup-python.

🎁 免费资料包

领取 AI 出海工具省钱大礼包

免费 API 清单、出海工具站案例、支付收款表、避坑指南和赚钱路径图,一次打包。

免费领取 →
🐑 小羊助手