Cloudflare Workers AI — это serverless-запуск ML-моделей на GPU глобальной сети Cloudflare: REST API или Binding из Worker, без своего железа. Фокус-ключ: cloudflare workers ai. Канон: Overview, REST API, Models. Соседи: OpenRouter, fal.ai, DeepInfra, ИИ-автоматизация.
Ниже — маршрут новичка: токен → Account ID → один ai/run на модели из get-started. Каталог и биллинг сверяйте на дату запуска; рублевый прайс не фиксируем.
Три пути интеграции
| Путь | Суть | Старт | Когда |
|---|---|---|---|
| REST API | HTTP из любого языка | Bearer + Account ID | проверка ключа за минуту |
| Workers Bindings | вызов из Worker/Pages | binding в wrangler | продакшен на Cloudflare |
| Dashboard | проба модели в UI | Workers AI в кабинете | выбор модели без кода |
| Models catalog | 50+ open-source моделей | workers-ai/models | текст, image, ASR, embeddings |
| AI Gateway | прокси/наблюдаемость | платформа Cloudflare | лимиты, кэш, логи рядом с Worker |
Источник: developers.cloudflare.com/workers-ai/ (GA, serverless, model catalog); get-started/rest-api (API Token, Account ID, @cf/meta/llama-3.1-8b-instruct); workers-ai/models. Сверка: 2026-10-11. ₽ не выдумываем.
Первый вызов через REST
- Откройте Workers AI в Cloudflare dashboard и выберите Use REST API.
- Создайте Workers AI API Token (нужны права Workers AI Read/Edit) и скопируйте Account ID.
- Экспортируйте значения в env:
CLOUDFLARE_ACCOUNT_ID,CLOUDFLARE_API_TOKEN. - Вызовите Execute AI model на
@cf/meta/llama-3.1-8b-instruct(пример из официального get-started). - Для прода сверяйте актуальный model slug в каталоге и лимиты/биллинг аккаунта.
export CLOUDFLARE_ACCOUNT_ID="your_account_id"
export CLOUDFLARE_API_TOKEN="your_api_token"
curl "https://api.cloudflare.com/client/v4/accounts/${CLOUDFLARE_ACCOUNT_ID}/ai/run/@cf/meta/llama-3.1-8b-instruct" \
-H "Authorization: Bearer ${CLOUDFLARE_API_TOKEN}" \
-H "Content-Type: application/json" \
-d '{ "prompt": "Where did the phrase Hello World come from" }'Ответ приходит JSON с полем result.response при success: true. Другой model id подставляйте из каталога Models; формат входа зависит от задачи модели (prompt, messages, image и т.д.).
Типичные ошибки
- Путать Account ID и Zone ID — для
/accounts/{ACCOUNT_ID}/ai/run/нужен именно Account ID. - Токен без прав Workers AI Read/Edit — запрос упадёт с 403.
- Копировать устаревший model slug вместо актуального из workers-ai/models.
- Коммитить API Token в репозиторий или в публичный фронтенд.
- Фиксировать рублевый прайс токенов/нейронов в статье — смотрите биллинг Cloudflare.
FAQ: Cloudflare Workers AI
Что такое Cloudflare Workers AI простыми словами?
Workers AI — это serverless-инференс моделей на GPU сети Cloudflare: вызываете модель из каталога через REST API или Workers Binding, без своего кластера. Канон: developers.cloudflare.com/workers-ai/.
Как сделать первый вызов через REST?
В дашборде Workers AI создайте API Token и скопируйте Account ID. Затем curl на https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/run/@cf/meta/llama-3.1-8b-instruct с Authorization: Bearer и JSON prompt.
Какой model id брать новичку?
В официальном REST get-started используют @cf/meta/llama-3.1-8b-instruct. Полный каталог — developers.cloudflare.com/workers-ai/models/. Перед продом сверяйте актуальный slug.
Чем Workers AI отличается от OpenRouter?
OpenRouter — единый API к моделям разных провайдеров. Workers AI — инференс в экосистеме Cloudflare (Workers, AI Gateway, Vectorize) с собственным каталогом. Соседи: /openrouter-kak-polzovatsya/, /fal-ai-kak-polzovatsya/, /ai-automation/.
Нужен ли Wrangler для первого теста?
Для REST API — нет: хватает Account ID, API Token и curl. Wrangler и Workers Bindings удобны, когда модель зовёте из Worker/Pages. См. get-started в доке.
Есть ли цены в рублях в статье?
Нет. Workers AI — pay-for-what-you-use; тарифы смотрите в документации Cloudflare и биллинге аккаунта. Рубли не фиксируем.
Вывод
Workers AI — Account ID, API Token, один ai/run на модели из get-started, дальше Binding или каталог под задачу. Старт: REST guide → свой curl → сверка Models. Когда нужна система обучения под интеграции — форматы на странице обучения.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Соседи по стеку — ИИ-автоматизация и fal.ai.