← Обзор / ai-search / configuration / indexing

Токен API службы

Токен API службы предоставляет AI Search разрешение на доступ к R2 bucket в вашем аккаунте. Этот токен нужен только в том случае, если вы подключаете R2 bucket в качестве источника данных. Если вы используете веб-сайт или загружаете файлы напрямую через API элементов, вам не нужен служебный токен API.

Когда вам нужен токен API службы

Токен API службы потребуется, если вы создаёте экземпляр AI Search с type: "r2". Токен разрешает AI Search читать объекты из вашего бакета R2 для индексирования.

Создание через dashboard или Wrangler

Проще всего получить токен API службы: создайте экземпляр AI Search на основе R2 через панель управления или Wrangler CLI хотя бы один раз. Cloudflare автоматически создаёт и регистрирует за вас токен службы в процессе настройки.

После создания токен сохраняется в вашем аккаунте и используется повторно во всех экземплярах AI Search. Создавать новый токен для каждого экземпляра не требуется.

Создание через API

Если вам нужно создать токен API службы программно, выполните следующие действия.

1. Создайте токен API с разрешением на создание токенов

Вам потребуется API-токен с разрешением создавать другие токены.

В панели управления Cloudflare перейдите в My Profile > API-токены.
Перейдите в API-токены ↗
Выберите Create Token.
Выберите Create Custom Token.
Введите Имя токена, например Token Creator.
В разделе Разрешения, выберите Пользователь > API-токены > Изменить.
Выберите Continue to summary, затем выберите Create Token.
Скопируйте и сохраните значение токена. Это ваш CREATOR_TOKEN.

2. Создайте служебный токен

Используйте API для создания токена и создайте токен службы с разрешением AI Search Index Engine. Замените <CREATOR_TOKEN> с токеном из шага 1 и <ACCOUNT_ID> с вашим ID аккаунта.

curl -X POST "https://api.cloudflare.com/client/v4/user/tokens" \
  -H "Authorization: Bearer <CREATOR_TOKEN>" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "AI Search Service API Token",
    "policies": [
      {
        "effect": "allow",
        "resources": {
          "com.cloudflare.api.account.<ACCOUNT_ID>": "*"
        },
        "permission_groups": [
          { "id": "9e9b428a0bcd46fd80e580b46a69963c" }
        ]
      }
    ]
  }'

Сохраните id и value из ответа:

{
	"result": {
		"id": "<CF_API_ID>",
		"name": "AI Search Service API Token",
		"status": "active",
		"value": "<CF_API_KEY>"
	},
	"success": true
}

3. Зарегистрируйте токен в AI Search

Используйте API токенов AI Search и зарегистрировать токен службы. Замените <API_TOKEN> с токеном API, у которого есть разрешения AI Search Edit.

curl -X POST "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/tokens" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  --data '{
    "cf_api_id": "<CF_API_ID>",
    "cf_api_key": "<CF_API_KEY>",
    "name": "AI Search Service Token"
  }'

Сохраните id из ответа. Это ваш token_id который нужно передать при создании инстансов на основе R2:

{
	"success": true,
	"result": {
		"id": "<TOKEN_ID>",
		"name": "AI Search Service Token",
		"cf_api_id": "<CF_API_ID>",
		"created_at": "2025-12-25 01:52:28",
		"enabled": true
	}
}

4. Используйте токен при создании экземпляра

Передайте token_id при создании экземпляра на основе R2:

curl -X POST "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/instances" \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  --data '{
    "id": "my-r2-docs",
    "type": "r2",
    "source": "<R2_BUCKET_NAME>",
    "token_id": "<TOKEN_ID>"
  }'

Управление токеном

После регистрации токен API службы надёжно сохраняется и используется повторно во всех экземплярах AI Search в вашем аккаунте.

Ротация токена

Чтобы создать новый токен API службы в dashboard:

Перейдите к существующему экземпляру AI Search в панели управления Cloudflare.
Перейдите в AI Search ↗
Выберите Настройки.
В разделе Общее, найдите Токен API службы и нажмите значок редактирования.
Выберите Создайте новый токен.
Выберите Save.

Чтобы создать новый токен через API, следуйте шаги с 1 по 3 выше.

Просмотр зарегистрированных токенов

Выведите список токенов API службы, зарегистрированных в AI Search в вашем аккаунте:

curl https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/tokens \
  -H "Authorization: Bearer <API_TOKEN>"