Source: https://ailoot.ai/models/en/qwen3-rerank/ Canonical: https://ailoot.ai/models/en/qwen3-rerank/ Language: en # Qwen: Qwen3 Rerank [Markdown](https://ailoot.ai/models/en/qwen3-rerank/index.md) · [JSON](https://ailoot.ai/models/en/qwen3-rerank/facts.json) ## [Qwen: Qwen3 Rerank](https://ailoot.ai/models/en/qwen3-rerank/) Qwen3 Rerank orders candidate text for a supplied query and instruction. The exact qwen3-rerank profile accepts text-document lists and returns indexed relevance scores with usage metadata for retrieval and document-selection workflows. - [**Ailoot Ultra · Rerank** `POST /v1/rerank` `qwen3-rerank`](https://ailoot.ai/models/en/qwen3-rerank/#method-0) About the model This description covers the model’s capabilities. Available in Ailoot inputs, outputs and options are listed for the selected method below. Qwen3 Rerank evaluates candidate text against a supplied query and ranking instruction. The exact configured selector is qwen3-rerank. Its role is ordering the supplied candidates for retrieval and document-selection work; the request keeps the query, instruction and candidate passages together so the relevance judgment can be traced back to its inputs. Prepare documents as an array of strings, with one candidate passage in each entry. Keep a separate mapping from each array position to your own document identifier, title or source location. This lets the application reconnect a ranked result with the original passage without adding undocumented identifier objects to the string array. For a support search, the candidates might be the relevant sections already retrieved from a product guide; the query should state the user's actual information need. The documented request requires model, documents, query, top\_n and instruct. The query and instruct fields are strings, and top\_n is an explicitly supplied integer. The published example uses three candidate texts, top\_n=2 and an instruction to retrieve relevant passages that answer a web-search query. Use instruct to state the relation that matters for the ranking, while keeping the actual question in query and the material to evaluate in documents. The operation guide lists a maximum input length of 30K. Keep the candidate passages focused on the text needed to judge their relevance, retaining headings or nearby context when those change the meaning. Preserve source boundaries so a selected passage can still be checked in its original document. The exact request profile and its required fields remain the basis for preparing the input. The returned structured result contains results entries with index and relevance\_score. The index refers to the candidate's position in the original documents array, rather than its position in the ranked result list. Keep the returned ordering and use each index to recover the corresponding input text. Preserve every returned result so the application can inspect the selected candidates and their scores together. Retain the complete JSON response, including its model, response id and usage.total\_tokens. The returned document text can be absent, so keep the original candidate array available when processing the indices. The relevance scores and reported usage have separate roles: scores describe the ranking result, while usage records the quantity reported for the operation. Neither replaces the source passage that supports a later answer. For a retrieval workflow, use the ranking to select the passages that the next step should inspect or cite. Compare a selected passage with the query and instruction before presenting its contents as evidence. A high position in a result list identifies a candidate for review; the application's eventual answer should remain connected to the actual text and its source identifier. Review the result with representative queries and the candidate sets used by the application. Check that indices resolve to the intended original texts, that the ordering serves the supplied instruction and that the chosen passages address the question. Keep the exact selector, query, instruction, candidate mapping and complete response together, producing a reusable relevance-selection record for the next retrieval or document step. **Ailoot Ultra · Rerank** `POST /v1/rerank` `qwen3-rerank` [`qwen3-rerank`](https://ailoot.ai/models/en/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) Qwen /`qwen3-rerank` ### Overview Qwen3 Rerank orders candidate text for a supplied query and instruction. The exact qwen3-rerank profile accepts text-document lists and returns indexed relevance scores with usage metadata for retrieval and document-selection workflows. Accepted inputs Text Results structured ### Available in Ailoot · inputs & methods **Ailoot Ultra · Rerank** `POST /v1/rerank` Input types `text` Output types `structured` Output format application/json | Field | Type | Requirement | Values & limits | Default | | --- | --- | --- | --- | --- | | Field`model` | Type`string` | RequirementRequired | Values & limits qwen3-rerank Conditions: Literal model selector. | Default— | | Field`documents` | Type`array` | RequirementRequired | Values & limits Conditions: Candidate text passages, kept in their original input order. | Default— | | Field`query` | Type`string` | RequirementRequired | Values & limits Conditions: Relevance query. | Default— | | Field`top_n` | Type`integer` | RequirementRequired | Values & limits Conditions: Requested number of ranked results; no undocumented minimum, maximum or default is asserted. | Default— | | Field`instruct` | Type`string` | RequirementRequired | Values & limits Conditions: Instruction describing the retrieval task. | Default— | Input material combinations Method parameters and lifecycle | Parameter | Contract | | --- | --- | | Parameter`content_type` | Contractapplication/json | | Parameter`required` | Contractmodel, documents, query, top\_n, instruct | | Parameter`optional` | Contract | | Parameter`material_types` | Contracttext | | Parameter`additional_properties` | Contracttrue | Lifecycle: `synchronous` ### Pricing Tariff references do not add request options. Supported parameters are listed for the selected method. Fast mode Not specified When fast mode is selected Flex mode Not specified When flex mode is selected Maximum reasoning effort Not specified When maximum reasoning effort uses the default adjustment #### Ailoot rates #### Prices by configuration Match each charge to the conditions shown. Use one rate for each set of alternative configurations. | Configuration | Rate schedule | Billing unit | Charge | | --- | --- | --- | --- | | ConfigurationBase token rates | Rate scheduleBase rate | Billing unit— | Charge Input · Input tokens **—** / 1K tokens Output · Output tokens **—** / 1K tokens Input · Cache read **—** / 1K tokens Input · Cache write **—** / 1K tokens Input · Cache write, 1 hour **—** / 1K tokens | | Configurationtotal token | Rate schedule— | Billing unit/ 1K tokens | Charge Input · total token **$0.00014** / 1K tokens | Ailoot reserves an estimated amount before a request. After the result, it settles the final charge from measured usage. Streaming settlement uses the final usage record. [How reservation and settlement work →](https://ailoot.ai/docs/en/billing/reserve/) ### Example requests #### Ailoot Ultra · Rerank JSON · rerank text ```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." } ``` ### Receive and save results #### Ailoot Ultra · Rerank Read indices and relevance scores and map each index back to your original documents. An echoed document can be absent. ##### If the original response needs checking Preserve the original response and request id after an ambiguous send; never replay it. Response fields | Field | Type | Meaning | | --- | --- | --- | | Field`results[].index` | Typeinteger | MeaningIndex of the corresponding original input document. | | Field`results[].relevance_score` | Typenumber | MeaningReturned relevance score. | | Field`model` | Typestring | MeaningActual response model. | | Field`id` | Typestring | MeaningActual response identifier. | | Field`usage.total_tokens` | Typeinteger | MeaningMeasured total tokens used for billing. | Errors and next steps | Response | Condition | Next step | | --- | --- | --- | | Response400 · `invalid_request_error` | ConditionInvalid JSON or required model selection. | Next stepCorrect the indicated input before a new request. | | Response401 · `authentication_error` | ConditionInvalid API key. | Next stepUse your valid Ailoot API key. | | Response503 · `price_unavailable` | ConditionStructured method pricing or admission is unavailable. | Next stepPreserve the original response; do not replay an ambiguous send. | ### Aliases #### Model aliases **Ailoot Ultra** [`qwen3-rerank`](https://ailoot.ai/models/en/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) #### Method path aliases Use the method paths shown above. #### Related caller IDs [`qwen3-rerank`](https://ailoot.ai/models/en/#m=qwen3-rerank&route=Ultra&caller=qwen3-rerank&fmt=rerank) FAQ · Qwen: Qwen3 Rerank What inputs and results are available? `POST /v1/rerank` · `qwen3-rerank`: `text` → `structured` Which fields does the request use? `POST /v1/rerank` · `qwen3-rerank`: `model`, `documents`, `query`, `top_n`, `instruct` Connect Ailoot to Claude Code, OpenCode, Hermes or your own app. ## The company and its project portfolio The company and its project portfolio: millions of customers; monthly sales in the billions. ## Buy tokens at a discount. Subscription discounts for regular use. Promo codes offer up to 50% off token purchases. Subscription Choose a discounted plan for your regular requests. Promo code: up to 50% off Enter your code at checkout. The price updates to reflect the current promotion. Spending in your history The model, tokens and amount are recorded for each request. [Choose a subscription](https://ailoot.ai/docs/en/billing/subscriptions/) · [View model prices](https://ailoot.ai/models/en/) ## Connect the API to a product you sell. Use Ailoot in SaaS, apps and bots under its official service offer and licence agreement. Request a reseller licence for resale. Commercial application Add text, image, video and audio generation to paid features in your service. Reseller licence Send a description of your project and how you provide access. Request written terms for use and resale. Documents on the website The service offer, licence agreement and data processing policy are available before you connect. [Request a reseller licence](mailto:support@ailoot.ai) · [Service offer and licence agreement](https://ailoot.ai/legal/offer?lang=en) ## Ailoot · The company and its project portfolio Ailoot combines established operating experience, a large client base, stable service and ongoing KPI control. The company and its project portfolio: millions of customers; monthly sales in the billions. Ailoot brings that operating experience to API access for AI features in customer products, agents, applications and automations.