Source: https://ailoot.ai/models/ja/qwen3-rerank/ Canonical: https://ailoot.ai/models/ja/qwen3-rerank/ Language: ja # Qwen: Qwen3 Rerank [Markdown](https://ailoot.ai/models/ja/qwen3-rerank/index.md) · [JSON](https://ailoot.ai/models/ja/qwen3-rerank/facts.json) ## [Qwen: Qwen3 Rerank](https://ailoot.ai/models/ja/qwen3-rerank/) Qwen3 Rerankは、提示したクエリと指示に基づいて候補テキストを並べ替えます。正確なqwen3-rerank仕様はテキスト文書のリストを受け取り、検索や文書選択のワークフローに使う、インデックス付きの関連度スコアと使用量メタデータを返します。 - [**Ailoot Ultra · 再ランキング** `POST /v1/rerank` `qwen3-rerank`](https://ailoot.ai/models/ja/qwen3-rerank/#method-0) モデルについて この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。 Qwen3 Rerankは、提示したクエリと順位付けの指示に照らして候補テキストを評価します。設定された正確なモデル指定はqwen3-rerankです。検索や文書選択のために、提示された候補を並べる役割を担います。リクエストではクエリ、指示、候補の記述を一緒に保持し、関連度の判断を入力にさかのぼって確認できるようにします。 documentsは文字列の配列として用意し、各要素に候補の記述を一つ入れます。配列の各位置から、独自の文書識別子、タイトル、出典の位置への対応表を別途保持します。これにより、文書化されていない識別子オブジェクトを文字列配列に追加せずに、順位付きの結果を元の記述へ結び直せます。サポート向けの検索なら、候補は製品ガイドからすでに取得した関連セクションなどです。クエリには、ユーザーが実際に必要としている情報を記します。 文書化されたリクエストではmodel、documents、query、top\_n、instructが必須です。queryとinstructは文字列で、top\_nは明示的に指定する整数です。公開されている例では、三つの候補テキスト、top\_n=2、ウェブ検索の質問に答える関連記述を取得するための指示を使っています。順位付けで重視する関係はinstructに記し、実際の質問はquery、評価対象の資料はdocumentsに入れます。 操作ガイドは最大入力長を30Kとしています。関連度を判断するために必要なテキストに候補の記述を絞り、意味が変わる場合は見出しや前後のコンテキストを残します。元の文書で選択された記述を確認できるよう、出典の境界を保ちます。正確なリクエスト仕様と必須フィールドを、入力を用意する際の基準とします。 返される構造化結果には、indexとrelevance\_scoreを持つresultsエントリが含まれます。indexは順位付き結果リスト内の位置ではなく、元のdocuments配列内での候補の位置を指します。返された順序を保ち、各indexを使って対応する入力テキストを取得します。返された結果をすべて保持し、アプリケーションが選択された候補とスコアをまとめて確認できるようにします。 model、応答のid、usage.total\_tokensを含む完全なJSONレスポンスを保持します。返却結果に文書テキストが含まれない場合もあるため、インデックスを処理する際に元の候補配列を使えるようにしておきます。関連度スコアと報告された使用量には別々の役割があり、スコアは順位付けの結果、使用量はその操作で報告された量を表します。どちらも、後の回答の根拠になる元の記述の代わりにはなりません。 検索ワークフローでは、この順位付けを使って、次の段階で確認や引用を行う記述を選びます。内容を根拠として提示する前に、選択した記述をクエリと指示に照らして確認します。結果リストで上位にあることは、確認すべき候補であることを示します。アプリケーションが最終的に返す回答は、実際のテキストとその出典識別子に結び付けておく必要があります。 代表的なクエリと、アプリケーションが使う候補集合で結果を確認します。インデックスが意図した元のテキストに対応すること、順序が提示した指示に役立つこと、選択した記述が質問に答えることを確認します。正確なモデル指定、クエリ、指示、候補の対応表、完全なレスポンスを一緒に保持し、次の検索や文書処理で再利用できる関連情報の選択記録を作成します。 **Ailoot Ultra · 再ランキング** `POST /v1/rerank` `qwen3-rerank` [`qwen3-rerank`](https://ailoot.ai/models/ja/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) Qwen /`qwen3-rerank` ### はじめに Qwen3 Rerankは、提示したクエリと指示に基づいて候補テキストを並べ替えます。正確なqwen3-rerank仕様はテキスト文書のリストを受け取り、検索や文書選択のワークフローに使う、インデックス付きの関連度スコアと使用量メタデータを返します。 対応する入力 テキスト 結果 structured ### Ailootで利用可能 · 入力とメソッド **Ailoot Ultra · 再ランキング** `POST /v1/rerank` 入力の種類 `text` 出力の種類 `structured` 出力形式 application/json | フィールド | 種類 | 要件 | 値と制限 | デフォルト | | --- | --- | --- | --- | --- | | フィールド`model` | 種類`string` | 要件必須 | 値と制限 qwen3-rerank 条件: モデル指定子のリテラル。 | デフォルト— | | フィールド`documents` | 種類`array` | 要件必須 | 値と制限 条件: 入力時の順序を維持した、候補のテキストパッセージ。 | デフォルト— | | フィールド`query` | 種類`string` | 要件必須 | 値と制限 条件: 関連度を評価するクエリ。 | デフォルト— | | フィールド`top_n` | 種類`integer` | 要件必須 | 値と制限 条件: 要求するランキング結果の件数。文書に記載のない最小値、最大値、デフォルト値は断定しません。 | デフォルト— | | フィールド`instruct` | 種類`string` | 要件必須 | 値と制限 条件: 検索タスクを記述する指示。 | デフォルト— | 入力素材の組み合わせ メソッドのパラメータとライフサイクル | パラメータ | 仕様 | | --- | --- | | パラメータ`content_type` | 仕様application/json | | パラメータ`required` | 仕様model, documents, query, top\_n, instruct | | パラメータ`optional` | 仕様 | | パラメータ`material_types` | 仕様text | | パラメータ`additional_properties` | 仕様true | ライフサイクル: `synchronous` ### 料金 料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。 高速モード 未指定 高速モードが選択されている場合 Flex モード 未指定 flex モードが選択されている場合 最大推論量 未指定 推論量が最大で、調整に既定値（default）を使用する場合 #### Ailootの料金 #### 設定別の価格 各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。 | 設定 | 料金表 | 課金単位 | 料金 | | --- | --- | --- | --- | | 設定基本トークン料金 | 料金表基本料金 | 課金単位— | 料金 入力 · 入力トークン **—** / 1K トークン 出力 · 出力トークン **—** / 1K トークン 入力 · キャッシュ読み取り **—** / 1K トークン 入力 · キャッシュ書き込み **—** / 1K トークン 入力 · キャッシュ書き込み、1時間 **—** / 1K トークン | | 設定合計トークン | 料金表— | 課金単位/ 1K トークン | 料金 入力 · 合計トークン **$0.00014** / 1K トークン | Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。[金額の確保と精算の仕組み →](https://ailoot.ai/docs/ja/billing/reserve/) ### リクエスト例 #### Ailoot Ultra · 再ランキング JSON · テキストを再順位付けする ```json { "model": "qwen3-rerank", "query": "Which passage discusses text ranking?", "documents": [ "Text ranking orders candidate passages by relevance.", "Quantum computing studies computation using quantum systems.", "Pretrained language models can improve text ranking." ], "top_n": 2, "instruct": "Given a web search query, retrieve relevant passages that answer the query." } ``` ### 結果を受け取って保存 #### Ailoot Ultra · 再ランキング インデックスと関連度スコアを読み取り、各インデックスを元の文書に対応付けてください。文書自体がそのまま返されるとは限りません。 ##### 元のレスポンスを確認する場合 送信結果が不明確な場合は、元のレスポンスとリクエストidを保持し、その送信を決して繰り返さないでください。 レスポンスのフィールド | フィールド | 種類 | 意味 | | --- | --- | --- | | フィールド`results[].index` | 種類integer | 意味対応する元の入力文書のインデックス。 | | フィールド`results[].relevance_score` | 種類number | 意味返された関連度スコア。 | | フィールド`model` | 種類string | 意味実際のレスポンスモデル。 | | フィールド`id` | 種類string | 意味実際のレスポンス識別子。 | | フィールド`usage.total_tokens` | 種類integer | 意味課金に使用する実測の合計トークン数。 | エラーと次の手順 | レスポンス | 条件 | 次の手順 | | --- | --- | --- | | レスポンス400 · `invalid_request_error` | 条件JSONまたは必須のモデル選択が無効です。 | 次の手順新しいリクエストを送る前に、指摘された入力を修正してください。 | | レスポンス401 · `authentication_error` | 条件無効な API キーです。 | 次の手順有効なAiloot APIキーを使用してください。 | | レスポンス503 · `price_unavailable` | 条件構造化されたメソッド料金情報を利用できないか、メソッドの利用許可が得られません。 | 次の手順元のレスポンスを保持してください。結果が不明確な送信を繰り返さないでください。 | ### エイリアス #### モデルのエイリアス **Ailoot Ultra** [`qwen3-rerank`](https://ailoot.ai/models/ja/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) #### メソッドパスのエイリアス 上記に表示されたメソッドパスを使用してください。 #### 関連する呼び出し用ID [`qwen3-rerank`](https://ailoot.ai/models/ja/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) FAQ · Qwen: Qwen3 Rerank 利用できる入力と結果は何ですか？ `POST /v1/rerank` · `qwen3-rerank`: `text` → `structured` リクエストはどの項目を使用しますか？ `POST /v1/rerank` · `qwen3-rerank`: `model`, `documents`, `query`, `top_n`, `instruct` AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。 ## 企業とそのプロジェクト群 企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。 ## トークンを割引価格で購入。 継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。 サブスクリプション 定期的なリクエストに合う割引プランを選びましょう。 最大50%のプロモコード 購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。 支出を履歴で確認 各リクエストのモデル、トークン、金額が保存されます。 [サブスクリプションを選ぶ](https://ailoot.ai/docs/ja/billing/subscriptions/) · [モデルの価格を見る](https://ailoot.ai/models/ja/) ## 販売する製品に、 APIを組み込みましょう。 SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。 商用アプリ サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。 リセラーライセンス プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。 サイトで契約文書を確認 接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。 [リセラーライセンスを申請](mailto:support@ailoot.ai) · [サービス提供条件とライセンス契約](https://ailoot.ai/legal/offer?lang=ja) ## Ailoot · 企業とそのプロジェクト群 Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。 企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。 Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。