サービス API トークン

サービス API トークンは、アカウント内の R2 バケットへアクセスする権限を AI Search に与えます。このトークンが必要なのは、データソースとして R2 バケットを接続する場合だけです。Web サイトを使う場合や、Items API からファイルを直接アップロードする場合は、サービス API トークンは不要です。

サービス API トークンが必要なとき

type: "r2" の AI Search インスタンスを作成するときに、サービス API トークンが必要です。トークンは、インデックス作成のために R2 バケットからオブジェクトを読む権限を AI Search に与えます。

ダッシュボードまたは Wrangler で作成する

サービス API トークンを得る最も簡単な方法は、ダッシュボードまたは Wrangler CLI で、R2 をデータソースとする AI Search インスタンスを少なくとも 1 回作成することです。セットアップの流れで、Cloudflare がサービストークンを自動で作成し、登録します。

一度作成すると、トークンはアカウントに保存され、すべての AI Search インスタンスで再利用されます。インスタンスごとに新しいトークンを作る必要はありません。

API で作成する

サービス API トークンをプログラムから作成する必要がある場合は、次の手順に従います。

1. トークン作成権限付きの API トークンを作成する

他のトークンを作成できる権限を持つ API トークンが必要です。

Cloudflare ダッシュボードで My Profile > API Tokens を開きます。
API Tokens を開く ↗
Create Token を選びます。
Create Custom Token を選びます。
Token name を入力します。例: Token Creator
Permissions で User > API Tokens > Edit を選びます。
Continue to summary を選び、Create Token を選びます。
トークン値をコピーして保存します。これが CREATOR_TOKEN です。

2. サービストークンを作成する

Create token 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 に登録する

AI Search tokens API を使い、サービストークンを登録します。<API_TOKEN> は、AI Search Edit 権限を持つ API トークンに置き換えます。

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 を保存します。これが、R2 をデータソースとするインスタンス作成時に渡す token_id です。

{
	"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. インスタンス作成時にトークンを使う

R2 をデータソースとするインスタンスを作成するとき、token_id を渡します。

curl -X POST "https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/ai-search/namespaces/default/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 トークンを作成するには:

Cloudflare ダッシュボードで既存の AI Search インスタンスを開きます。
AI Search を開く ↗
Settings を選びます。
General の Service API Token を探し、編集アイコンを選びます。
Create a new token を選びます。
Save を選びます。

API で新しいトークンを作成するには、上記のステップ 1 から 3 に従います。

登録済みトークンを表示する

アカウントで AI Search に登録されているサービス API トークンを一覧します。

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