Summary

Cloudflare AI Search は OpenAI 互換の REST API エンドポイントを提供します。/search と /chat/completions が追加され、OpenAI の messages 配列フォーマットを使って既存の SDK と互換に動作します。messages に前の発言を含めることでセッション間のコンテキストを維持できます。

Key Points

エンドポイント:

POST /accounts/{account_id}/ai-search/instances/{name}/chat/completions
POST /accounts/{account_id}/ai-search/instances/{name}/search

リクエスト形式: messages 配列（例: role: system, role: user）

認証: Authorization: Bearer {API_TOKEN}、Content-Type: application/json

互換性: 既存の OpenAI SDK/ツールと連携可能

移行: 旧 AutoRAG (/autorag/rags/) からの移行を推奨。新機能は新エンドポイントに追加され、少なくとも 90 日の猶予があります。移行ガイドを参照してください。

例（curl）: curl 'https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/instances/{NAME}/chat/completions' -H 'Content-Type: application/json' -H 'Authorization: Bearer {API_TOKEN}' -d '{"messages":[{"role":"system","content":"You are a helpful documentation assistant."},{"role":"user","content":"How do I get started?"}]}'

openaijamodel: gpt-5-mini-2025-08-07

AI Search - /search と /chat/completions の新しい AI Search REST API エンドポイント

新しい AI Search REST API エンドポイント (/search と /chat/completions)

公開日: 2026-03-23

AI Search は、OpenAI 互換フォーマットを使用する検索およびチャット用の新しい REST API エンドポイントを提供します。これにより、既存の OpenAI SDK やツールで使われている馴染みのある messages 配列構造を利用できます。messages 配列を使うことで、セッション内の以前のメッセージを渡して、モデルが複数ターンにわたってコンテキストを維持できるようになります。

エンドポイントパス

Chat Completions

POST /accounts/{account_id}/ai-search/instances/{name}/chat/completions
Search

POST /accounts/{account_id}/ai-search/instances/{name}/search

例: Chat Completions エンドポイントへのリクエスト

ターミナル:

curl https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai-search/instances/{NAME}/chat/completions \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer {API_TOKEN}" \
 -d '{ "messages": [ { "role": "system", "content": "You are a helpful documentation assistant." }, { "role": "user", "content": "How do I get started?" } ] }'

詳細については、AI Search REST API guide を参照してください。

既存の AutoRAG API からの移行（推奨）

以前の AutoRAG API エンドポイント (/autorag/rags/) を使用している場合は、可能な限り早く新しいエンドポイントへ移行することを推奨します。新機能は今後新しいエンドポイントにのみ追加されます。以前の AutoRAG エンドポイントは当面の間は引き続き動作しますが、変更の少なくとも 90 日前に通知を行います。

移行手順の詳細については、migration guide を参照してください。

リソース

AI Search REST API guide
Migration guide

AI Search - New AI Search REST API endpoints for /search and /chat/completions

要約