Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

サービス API トークン

最終更新 Markdown で表示Agent セットアップ

サービス 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 トークン が必要です。

  1. Cloudflare ダッシュボードで My Profile > API Tokens を開きます。

    公式ダッシュボードで API Tokens を開く ↗
  2. Create Token を選びます。

  3. Create Custom Token を選びます。

  4. Token name を入力します。例: Token Creator

  5. Permissions で User > API Tokens > Edit を選びます。

  6. Continue to summary を選び、Create Token を選びます。

  7. トークン値をコピーして保存します。これが 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 トークンを作成するには:

  1. Cloudflare ダッシュボードで既存の AI Search インスタンスを開きます。

    公式ダッシュボードで AI Search を開く ↗
  2. Settings を選びます。

  3. General の Service API Token を探し、編集アイコンを選びます。

  4. Create a new token を選びます。

  5. 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>"

役に立ちましたか?