OpenAICloudflare Developer Platform2026/03/16 0:00

Vectorize - Return up to 50 query results with values or metadata

要点だけを先に読めるように短く再構成したセクションです。

元記事

OpenAI Claude

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

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

Vectorize — 値/メタデータ返却時の topK 上限が50に

vectorize topk vector-search metadata api limits

Key Points

topKが50に拡大
値／メタデータ返却対応
以前の上限は20

Summary

Cloudflare の Vectorize API で、クエリが値を返す (returnValues: true) またはフルメタデータを返す (returnMetadata: "all") 場合の topK 上限が従来の 20 から 50 に引き上げられました。1 回の応答でより多くのマッチを取得できます。

Key Points

対象: returnValues: true または returnMetadata: "all" を使用するクエリ
変更: topK の最大値が 20 → 50 に増加
利点: 値やフルメタデータを保持したまま、単一クエリでより多くの結果を取得可能
実運用の注意: topK を増やすと応答サイズとレイテンシが増加する可能性があるため、必要に応じて調整すること
参照: 詳細・現在の制限は Vectorize API リファレンスを確認してください。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

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

Vectorize - 値またはメタデータを含むクエリ結果を最大50件返す

値またはメタデータを含むクエリ結果を最大50件返す

公開日: 2026-03-16
製品: Vectorize

Vectorize のクエリで returnValues: true または returnMetadata: "all" を使用する場合、topK を最大 50 に設定できるようになりました。これにより、これまでの上限であった 20 件から引き上げられ、値やフルメタデータを削除せずに、1 回のクエリ応答でより多くの一致を取得できます。

主なポイント

変更点: topK の上限が 20 → 50 に拡張されました。
対象となるクエリ: returnValues: true または returnMetadata: "all" を使用するクエリ。
利点: 値やメタデータを保持したまま、より多くの一致（最大 50 件）を一度に取得可能。

利用方法

クエリで topK を希望する数（最大 50）に設定してください。
returnValues と returnMetadata の設定は従来通り使用します（例: returnValues: true、returnMetadata: "all"）。

参照

Vectorize API reference でクエリオプションと現在の topK 上限を確認してください。

この記事は役に立ちましたか？はい / いいえ