← Přehled / ai-search / configuration / indexing

Token API služby

Token API služby uděluje AI Search oprávnění k přístupu k R2 ve vašem účtu. Tento token je nutný pouze v případě, že jako zdroj dat připojujete bucket R2. Pokud používáte web nebo nahráváte soubory přímo přes Items API, nepotřebujete servisní token API.

Servisní token API potřebujete, když vytváříte instanci AI Search s type: "r2". Token opravňuje AI Search číst objekty z vašeho R2 bucketu za účelem indexování.

Nejjednodušší způsob, jak získat servisní token API, je vytvořit instanci AI Search využívající R2 prostřednictvím dashboard nebo Wrangler CLI alespoň jednou. Cloudflare za vás během nastavení automaticky vytvoří a zaregistruje token služby.

Po vytvoření se token uloží k vašemu účtu a znovu se použije u všech instancí AI Search. Pro každou instanci nemusíte vytvářet nový token.

Pokud potřebujete vytvořit servisní token API programově, postupujte podle následujících kroků.

Potřebujete API token s oprávněním vytvářet další tokeny.

1. V Cloudflare dashboardu přejděte na My Profile > API Tokens.

   Přejděte na API Tokens ↗

2. Vyberte Create Token.

3. Vyberte Create Custom Token.

4. Zadejte Název tokenu, například Token Creator.

5. V části Oprávnění, vyberte Uživatel > API Tokens > Úprava.

6. Vyberte Pokračovat k souhrnu, pak vyberte Create Token.

7. Zkopírujte a uložte hodnotu tokenu. Toto je váš CREATOR_TOKEN.

Použijte API pro vytvoření tokenu a vytvořte token služby s oprávněním AI Search Index Engine. Nahraďte <CREATOR_TOKEN> s tokenem z kroku 1 a <ACCOUNT_ID> s vaším ID účtu.

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" }
        ]
      }
    ]
  }'

Uložte id a value z odpovědi:

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

Použijte API pro tokeny AI Search a zaregistrujte token služby. Nahraďte <API_TOKEN> s API tokenem, který má oprávnění 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"
  }'

Uložte id z odpovědi. Toto je váš token_id který předáváte při vytváření instancí založených na 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
	}
}

Předejte token_id při vytváření instance s podporou 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>"
  }'

Po registraci se servisní token API bezpečně uloží a znovu použije u všech instancí AI Search ve vašem účtu.

Chcete-li vytvořit nový servisní token API z řídicího panelu:

1. Přejděte na existující instanci AI Search v Cloudflare dashboardu.

   Přejděte na AI Search ↗

2. Vyberte Nastavení.

3. V části Obecné, najděte Token API služby a klikněte na ikonu úprav.

4. Vyberte Vytvořte nový token.

5. Vyberte Save.

Chcete-li vytvořit nový token přes API, postupujte podle kroky 1 až 3 výše.

Vypište servisní tokeny API zaregistrované u AI Search ve vašem účtu:

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