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

2026年3月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

使用例

新しいmessages配列フォーマットを使用した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ガイドを参照してください。

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

以前のAutoRAG APIエンドポイント（/autorag/rags/）を使用している場合は、可能な限り早急に移行することをお勧めします。新機能は新しいエンドポイントにのみ追加される予定です。

以前のAutoRAG APIエンドポイントは当面の間、期待通りに動作し続けますが、変更を行う場合は少なくとも90日前に通知いたします。

ステップバイステップの手順については、移行ガイドを参照してください。