TypeSafe Jev が意図を理解し、結果をリランキングする自然言語検索 API
リクエストを自然言語で送るだけ。TypeSafe の Jev モデルが意図を読み取り、エンジンと期間を選び、すべての結果を関連度でリランキングしてからエージェントに返します。
エンドポイント
自然言語のリクエストを 1 つ送ると、リランキング済みのソース一覧が返ります。意図理解、エンジン選択、関連度採点は TypeSafe の Jev モデルが担当します。
検索クエリと期間をリクエストから判断。
12 エンジンから最大 5 つを並列検索。
全結果を採点し、無関係な結果を除外。
活用例
LLM エージェントのツール / RAG 検索 / コミュニティ調査
意図理解・エンジン選択・リランキングを 1 回の呼び出しで
Search API ではエンジンとキーワードをコード側で決めます。Ask はその判断を API 側で行います。「今月 Bun 1.3 について開発者は何と言っているか」は通常 1 か月の期間で Hacker News、Reddit、X と一般の Web 検索エンジンへ、「投機的デコーディングの最新論文」は arXiv へルーティングされます。すべてのエンジンの結果をリクエストに照らして採点するため、LLM が読むのは各エンジンの上位結果ではなく、テーマに合ったソースです。
AI による意図理解
TypeSafe の Jev モデルがリクエストを読み取り、検索キーワードと期間を決めます。time_range で期間を自分で指定することもできます。
エンジン自動ルーティング
Jev が Google、Reddit、Hacker News、GitHub、arXiv、X、YouTube など 12 のエンジンを評価し、最大 5 つを並列で検索します。sources で自分で指定することもできます。
AI リランキング
Jev がすべての結果の関連度を採点。0.5 未満の結果を除外し、重複をまとめ、各結果にスコアを残します。
一律 5 クレジット（モデル込み）
完了したリクエストは検索したエンジン数に関わらず 5 クレジット。どのエンジンも完了しなかった場合は課金されません。
TypeSafe Jev とは？Ask が採用する理由
Jev は TypeSafe AI の System One モデルです。テキストを生成する代わりに、型付きの質問に較正済みの確率で答えるため、検索の判断に向いています。Ask はリクエストごとに Jev へ型付きの質問をします。ユーザーの意図に最も合う検索クエリはどれか（IMDb のようなカタログ向けには正確なタイトルも）、12 のエンジンそれぞれがリクエストにどれだけ合うか、期間の指定が含まれるか。これらの答えが意図理解とエンジンのルーティングを決めます。検索後には、返ってきた各結果が求められたテーマに関するものかを Jev に尋ね、その確率がリランキングと除外に使う関連度スコアになります。Jev は文章ではなく判断を返すため、Ask が独自に回答文を書くことはありません。Ask は TypeSafe の API 経由で Jev を利用し（障害時は Cloudflare Workers AI 上の同じモデルに切り替え）、TypeSafe の公式製品ではなく Search1API の製品です。
Ask の料金
Ask は完了したリクエストごとに一律 5 クレジットで、検索したエンジンが 1 つでも 5 つでも同じです。Jev モデルの呼び出し費用も含まれます。一部のエンジンが失敗して他が完了した場合は errors に失敗が記録され、課金されます。どのエンジンも完了しなかった場合は 502 を返し、課金されません。新規アカウントには 100 無料クレジットが付与され、Ask を 20 回実行できます。
1 リクエスト一律 5 クレジット（モデル呼び出し込み）。
どのエンジンも完了しなかった場合（HTTP 502）は課金なし。
登録時 100 無料クレジット — クレジットカード不要で Ask を 20 回。
API キーが必要。アカウントあたり毎分 30 リクエストまで。
Ask リクエストの流れ
リクエストを自然言語で送るだけ。TypeSafe の Jev モデルが意図を読み取り、エンジンと期間を選び、すべての結果を関連度でリランキングしてからエージェントに返します。
意図理解：Jev が検索クエリを選び、各エンジンの適合度を採点し、期間を判断します。sources と time_range で上書きできます。
並列検索：Google や DuckDuckGo から Reddit、GitHub、arXiv、YouTube まで、最大 5 つのエンジンを同時に検索します。
AI リランキング：Jev が全結果を採点し、0.5 未満を除外、重複を統合して関連度順に並べます。
主な用途
自然言語検索 API：TypeSafe Jev が意図を理解し、適切なエンジンへルーティングし、全結果を関連度でリランキング
検索ツールを 1 つにまとめたい LLM エージェント。ユーザーの質問をそのまま渡し、リランキング済みで引用できるソースを受け取れます。
結果の量より、適切なソースを選ぶことが重要な RAG 検索。
質問ごとに適したソースが変わる、Reddit、Hacker News、X、GitHub、arXiv の調査やモニタリング。
FAQ
自然言語検索 API とは何ですか？
人が尋ねるような文章のリクエストを受け取り、どう検索するかを API 側で判断する検索 API です。Ask はリクエストを検索クエリに変換し、エンジンと期間を選び、リクエストとの関連度でリランキングした結果を返します。
Ask はどのように検索意図を理解しますか？
Ask は TypeSafe の Jev モデルに、どの検索クエリが最適か、各エンジンが役立つ確率、期間の指定が含まれるかといった型付きの質問をします。エンジンはその確率に基づいて最大 5 つ選ばれます。レスポンスの intent で、実際に使われたキーワード・エンジン・期間を確認できます。
Ask はどのように結果をリランキングしますか？
Jev が各結果について、リクエストのテーマに関するものかを 0〜1 で採点します。0.5 未満は除外し、エンジン間の重複を統合し、残りをスコア順に並べます。各結果には relevance スコアが残るため、より厳しい基準で絞り込むこともできます。スコアはモデルの判断であり、事実確認ではありません。
Search ではなく Ask を使うべきなのはどんなときですか？
探したいものは分かっているが、どこを探すべきか分からないときは Ask を使います。エンジンとキーワードが決まっていて、そのエンジン自体のランキング、フィルター、ページング、Deep Search の本文が必要なときは Search を使います。
Ask API のクレジット消費は？
完了した Ask リクエストは、検索したエンジン数に関わらず一律 5 クレジットで、Jev モデルの呼び出しも含まれます。どのエンジンも完了しなかった場合は 502 を返し、課金されません。
Ask は回答文を生成しますか？
いいえ。Ask はタイトル・URL・スニペット・関連度スコア付きのリランキング済み結果を返し、自分の LLM で読んで引用できるようにします。要約や回答は生成しません。
Ask は Jev モデルにどのデータを送りますか？
意図理解と採点のため、リクエストと、返ってきた結果のタイトルとスニペットを Jev モデルに送ります（TypeSafe の API 経由、障害時は Cloudflare Workers AI 経由）。検索そのものは Search1API が実行します。
SDK や MCP から Ask を使えますか？
まだ使えません。API キーを使って HTTP で POST /ask を呼び出してください。公式 SDK、CLI、MCP サーバーは Ask に未対応で、従量決済（pay-per-request）にも対応していません。