Qwen: Qwen3 Rerank
Qwen3 Rerank classe les textes candidats pour une requête et une instruction fournies. Le profil exact qwen3-rerank accepte des listes de documents textuels et renvoie des scores de pertinence indexés avec des métadonnées d’utilisation pour la recherche d’information et la sélection de documents.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Qwen3 Rerank évalue les textes candidats au regard d’une requête et d’une instruction de classement fournies. Le sélecteur exact configuré est qwen3-rerank. Son rôle consiste à classer les candidats fournis pour la recherche d’information et la sélection de documents ; la requête regroupe la question, l’instruction et les passages candidats afin que l’évaluation de pertinence puisse être reliée à ses entrées.
Préparez documents sous la forme d’un tableau de chaînes, avec un passage candidat dans chaque entrée. Conservez séparément une correspondance entre chaque position du tableau et votre propre identifiant de document, titre ou emplacement dans la source. L’application peut ainsi relier un résultat classé au passage d’origine sans ajouter d’objets identifiants non documentés au tableau de chaînes. Pour une recherche d’assistance, les candidats peuvent être les sections pertinentes déjà extraites d’un guide produit ; la question doit exprimer le besoin d’information réel de l’utilisateur.
La requête documentée exige model, documents, query, top_n et instruct. Les champs query et instruct sont des chaînes, et top_n est un entier explicitement fourni. L’exemple publié utilise trois textes candidats, top_n=2 et une instruction visant à récupérer des passages pertinents qui répondent à une requête de recherche sur le Web. Utilisez instruct pour préciser la relation qui importe pour le classement, tout en plaçant la question réelle dans query et les éléments à évaluer dans documents.
Le guide de l’opération indique une longueur maximale d’entrée de 30K. Limitez les passages candidats au texte nécessaire pour juger leur pertinence, en conservant les titres ou le contexte proche lorsque ceux-ci modifient le sens. Préservez les limites entre les sources afin qu’un passage sélectionné puisse toujours être vérifié dans son document d’origine. Le profil exact de la requête et ses champs obligatoires restent la base de préparation de l’entrée.
Le résultat structuré renvoyé contient des entrées results avec index et relevance_score. index désigne la position du candidat dans le tableau documents d’origine, et non sa position dans la liste des résultats classés. Conservez l’ordre renvoyé et utilisez chaque index pour retrouver le texte d’entrée correspondant. Préservez chaque résultat renvoyé afin que l’application puisse examiner ensemble les candidats sélectionnés et leurs scores.
Conservez la réponse JSON complète, y compris ses valeurs model et id ainsi que usage.total_tokens. Le texte du document peut être absent de la réponse ; gardez donc le tableau de candidats d’origine à disposition lors du traitement des indices. Les scores de pertinence et l’utilisation déclarée ont des rôles distincts : les scores décrivent le résultat du classement, tandis que l’utilisation consigne la quantité déclarée pour l’opération. Aucun des deux ne remplace le passage source qui étaye une réponse ultérieure.
Dans un processus de recherche d’information, utilisez le classement pour sélectionner les passages que l’étape suivante doit examiner ou citer. Comparez un passage sélectionné à la question et à l’instruction avant d’en présenter le contenu comme un élément de preuve. Une position élevée dans la liste des résultats désigne un candidat à examiner ; la réponse finale de l’application doit rester reliée au texte réel et à son identifiant de source.
Examinez le résultat à l’aide de requêtes représentatives et des ensembles de candidats utilisés par l’application. Vérifiez que les indices renvoient aux textes d’origine prévus, que l’ordre répond à l’instruction fournie et que les passages choisis traitent la question. Conservez ensemble le sélecteur exact, la question, l’instruction, la correspondance des candidats et la réponse complète pour produire un relevé réutilisable de sélection par pertinence lors de l’étape suivante de recherche d’information ou de traitement documentaire.
Ailoot Ultra · Reclassement POST /v1/rerank qwen3-rerank
qwen3-rerankPremiers pas
Qwen3 Rerank classe les textes candidats pour une requête et une instruction fournies. Le profil exact qwen3-rerank accepte des listes de documents textuels et renvoie des scores de pertinence indexés avec des métadonnées d’utilisation pour la recherche d’information et la sélection de documents.
- Entrées acceptées
- Texte
- Résultats
- structured
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Reclassement POST /v1/rerank
- Types d’entrée
text- Types de sortie
structured- Format de sortie
- application/json
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites qwen3-rerank Conditions: Valeur littérale du sélecteur de modèle. | Par défaut— |
Champdocuments | Typearray | ExigenceObligatoire | Valeurs et limites Conditions: Passages de texte candidats, conservés dans leur ordre d’entrée d’origine. | Par défaut— |
Champquery | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Requête de pertinence. | Par défaut— |
Champtop_n | Typeinteger | ExigenceObligatoire | Valeurs et limites Conditions: Nombre de résultats classés demandé ; aucun minimum, maximum ou réglage par défaut non documenté n’est affirmé. | Par défaut— |
Champinstruct | Typestring | ExigenceObligatoire | Valeurs et limites Conditions: Instruction décrivant la tâche de recherche. | Par défaut— |
Combinaisons d’éléments d’entrée
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, documents, query, top_n, instruct |
Paramètreoptional | Contrat |
Paramètrematerial_types | Contrattext |
Paramètreadditional_properties | Contrattrue |
Cycle de vie : synchronous
Tarifs
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs Ailoot
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Unité de facturation | Coût |
|---|---|---|---|
| ConfigurationTarifs de base par jeton | Barème tarifaireTarif de base | Unité de facturation— | Coût Entrée · Tokens en entrée — / 1K tokens Sortie · Tokens en sortie — / 1K tokens Entrée · Lecture du cache — / 1K tokens Entrée · Écriture dans le cache — / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
| Configurationtotal de jetons | Barème tarifaire— | Unité de facturation/ 1K tokens | Coût Entrée · total de jetons $0.00014 / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Reclassement
{
"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."
}Recevoir et enregistrer les résultats
Ailoot Ultra · Reclassement
Consultez les index et les scores de pertinence, puis associez chaque index à vos documents d’origine. Le document repris dans la réponse peut être absent.
Si la réponse d’origine doit être vérifiée
Conservez la réponse et l’identifiant de requête d’origine après un envoi ambigu ; ne le rejouez jamais.
Champs de la réponse
| Champ | Type | Signification |
|---|---|---|
Champresults[].index | Typeinteger | SignificationIndex du document d’entrée d’origine correspondant. |
Champresults[].relevance_score | Typenumber | SignificationScore de pertinence renvoyé. |
Champmodel | Typestring | SignificationModèle réellement indiqué dans la réponse. |
Champid | Typestring | SignificationIdentifiant réel de la réponse. |
Champusage.total_tokens | Typeinteger | SignificationNombre total mesuré de tokens utilisé pour la facturation. |
Erreurs et étapes suivantes
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionJSON ou sélection de modèle obligatoire non valide. | Étape suivanteCorrigez l’entrée indiquée avant d’envoyer une nouvelle demande. |
Réponse401 · authentication_error | ConditionClé API invalide. | Étape suivanteUtilisez votre clé API Ailoot valide. |
Réponse503 · price_unavailable | ConditionLa tarification structurée ou l’autorisation d’accès à la méthode n’est pas disponible. | Étape suivanteConservez la réponse d’origine ; ne rejouez pas un envoi ambigu. |
Alias
Alias du modèle
Ailoot Ultra qwen3-rerank
Alias des chemins de méthode
Utilisez les chemins de méthode indiqués ci-dessus.
ID d’appel associés
FAQ · Qwen: Qwen3 Rerank
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/rerank·qwen3-rerank:text→structured- Quels champs la requête utilise-t-elle ?
POST /v1/rerank·qwen3-rerank:model,documents,query,top_n,instruct