Qwen3 Rerank evalúa textos candidatos según una consulta y una instrucción de ordenación proporcionadas. El selector exacto configurado es qwen3-rerank. Su función es ordenar los candidatos proporcionados para tareas de recuperación y selección de documentos; la solicitud mantiene juntos la consulta, la instrucción y los pasajes candidatos para que la evaluación de relevancia pueda vincularse a sus entradas.
Prepara documents como un array de cadenas, con un pasaje candidato en cada entrada. Mantén una correspondencia independiente entre cada posición del array y tu propio identificador de documento, título o ubicación de origen. Esto permite a la aplicación volver a relacionar un resultado ordenado con el pasaje original sin añadir objetos identificadores no documentados al array de cadenas. Para una búsqueda de asistencia, los candidatos podrían ser las secciones pertinentes ya recuperadas de una guía de producto; la consulta debe indicar la necesidad real de información del usuario.
La solicitud documentada requiere model, documents, query, top_n e instruct. Los campos query e instruct son cadenas y top_n es un entero que debe proporcionarse explícitamente. El ejemplo publicado utiliza tres textos candidatos, top_n=2 y una instrucción para recuperar pasajes pertinentes que respondan a una consulta de búsqueda web. Utiliza instruct para indicar la relación que importa para la ordenación, manteniendo la pregunta real en query y el material que debe evaluarse en documents.
La guía de la operación indica una longitud máxima de entrada de 30K. Limita los pasajes candidatos al texto necesario para evaluar su relevancia y conserva los títulos o el contexto cercano cuando cambien el significado. Preserva los límites de las fuentes para que un pasaje seleccionado pueda comprobarse en su documento original. El perfil exacto de la solicitud y sus campos obligatorios siguen siendo la base para preparar la entrada.
El resultado estructurado devuelto contiene entradas results con index y relevance_score. El valor index se refiere a la posición del candidato en el array documents original, no a su posición en la lista de resultados ordenados. Conserva el orden devuelto y utiliza cada index para recuperar el texto de entrada correspondiente. Guarda todos los resultados devueltos para que la aplicación pueda examinar juntos los candidatos seleccionados y sus puntuaciones.
Conserva la respuesta JSON completa, incluidos model, el id de respuesta y usage.total_tokens. El texto del documento devuelto puede estar ausente, por lo que debes mantener disponible el array original de candidatos al procesar los índices. Las puntuaciones de relevancia y el uso comunicado tienen funciones distintas: las puntuaciones describen el resultado de la ordenación, mientras que el uso registra la cantidad comunicada para la operación. Ninguno sustituye al pasaje fuente que respalda una respuesta posterior.
Para un flujo de recuperación, utiliza la ordenación para seleccionar los pasajes que el siguiente paso debe examinar o citar. Compara un pasaje seleccionado con la consulta y la instrucción antes de presentar su contenido como prueba. Una posición alta en una lista de resultados identifica un candidato para revisión; la respuesta final de la aplicación debe seguir vinculada al texto real y a su identificador de origen.
Revisa el resultado con consultas representativas y los conjuntos de candidatos utilizados por la aplicación. Comprueba que los índices correspondan a los textos originales previstos, que la ordenación responda a la instrucción proporcionada y que los pasajes elegidos aborden la pregunta. Conserva juntos el selector exacto, la consulta, la instrucción, la correspondencia de candidatos y la respuesta completa para producir un registro reutilizable de selección por relevancia para el siguiente paso de recuperación o de trabajo con documentos.
", "aboutText": "Qwen3 Rerank evalúa textos candidatos según una consulta y una instrucción de ordenación proporcionadas. El selector exacto configurado es qwen3-rerank. Su función es ordenar los candidatos proporcionados para tareas de recuperación y selección de documentos; la solicitud mantiene juntos la consulta, la instrucción y los pasajes candidatos para que la evaluación de relevancia pueda vincularse a sus entradas.\n\nPrepara documents como un array de cadenas, con un pasaje candidato en cada entrada. Mantén una correspondencia independiente entre cada posición del array y tu propio identificador de documento, título o ubicación de origen. Esto permite a la aplicación volver a relacionar un resultado ordenado con el pasaje original sin añadir objetos identificadores no documentados al array de cadenas. Para una búsqueda de asistencia, los candidatos podrían ser las secciones pertinentes ya recuperadas de una guía de producto; la consulta debe indicar la necesidad real de información del usuario.\n\nLa solicitud documentada requiere model, documents, query, top_n e instruct. Los campos query e instruct son cadenas y top_n es un entero que debe proporcionarse explícitamente. El ejemplo publicado utiliza tres textos candidatos, top_n=2 y una instrucción para recuperar pasajes pertinentes que respondan a una consulta de búsqueda web. Utiliza instruct para indicar la relación que importa para la ordenación, manteniendo la pregunta real en query y el material que debe evaluarse en documents.\n\nLa guía de la operación indica una longitud máxima de entrada de 30K. Limita los pasajes candidatos al texto necesario para evaluar su relevancia y conserva los títulos o el contexto cercano cuando cambien el significado. Preserva los límites de las fuentes para que un pasaje seleccionado pueda comprobarse en su documento original. El perfil exacto de la solicitud y sus campos obligatorios siguen siendo la base para preparar la entrada.\n\nEl resultado estructurado devuelto contiene entradas results con index y relevance_score. El valor index se refiere a la posición del candidato en el array documents original, no a su posición en la lista de resultados ordenados. Conserva el orden devuelto y utiliza cada index para recuperar el texto de entrada correspondiente. Guarda todos los resultados devueltos para que la aplicación pueda examinar juntos los candidatos seleccionados y sus puntuaciones.\n\nConserva la respuesta JSON completa, incluidos model, el id de respuesta y usage.total_tokens. El texto del documento devuelto puede estar ausente, por lo que debes mantener disponible el array original de candidatos al procesar los índices. Las puntuaciones de relevancia y el uso comunicado tienen funciones distintas: las puntuaciones describen el resultado de la ordenación, mientras que el uso registra la cantidad comunicada para la operación. Ninguno sustituye al pasaje fuente que respalda una respuesta posterior.\n\nPara un flujo de recuperación, utiliza la ordenación para seleccionar los pasajes que el siguiente paso debe examinar o citar. Compara un pasaje seleccionado con la consulta y la instrucción antes de presentar su contenido como prueba. Una posición alta en una lista de resultados identifica un candidato para revisión; la respuesta final de la aplicación debe seguir vinculada al texto real y a su identificador de origen.\n\nRevisa el resultado con consultas representativas y los conjuntos de candidatos utilizados por la aplicación. Comprueba que los índices correspondan a los textos originales previstos, que la ordenación responda a la instrucción proporcionada y que los pasajes elegidos aborden la pregunta. Conserva juntos el selector exacto, la consulta, la instrucción, la correspondencia de candidatos y la respuesta completa para producir un registro reutilizable de selección por relevancia para el siguiente paso de recuperación o de trabajo con documentos.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "8261bef96afa97546c889e33ba77466203720f0a3d0a8a86d7f05df1500346d4", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "es", "methods": [ { "html": "qwen3-rerankQwen3 Rerank ordena textos candidatos según una consulta y una instrucción proporcionadas. El perfil exacto qwen3-rerank acepta listas de documentos de texto y devuelve puntuaciones de relevancia con índices y metadatos de uso para flujos de recuperación y selección de documentos.
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
Qwen3 Rerank evalúa textos candidatos según una consulta y una instrucción de ordenación proporcionadas. El selector exacto configurado es qwen3-rerank. Su función es ordenar los candidatos proporcionados para tareas de recuperación y selección de documentos; la solicitud mantiene juntos la consulta, la instrucción y los pasajes candidatos para que la evaluación de relevancia pueda vincularse a sus entradas.
Prepara documents como un array de cadenas, con un pasaje candidato en cada entrada. Mantén una correspondencia independiente entre cada posición del array y tu propio identificador de documento, título o ubicación de origen. Esto permite a la aplicación volver a relacionar un resultado ordenado con el pasaje original sin añadir objetos identificadores no documentados al array de cadenas. Para una búsqueda de asistencia, los candidatos podrían ser las secciones pertinentes ya recuperadas de una guía de producto; la consulta debe indicar la necesidad real de información del usuario.
La solicitud documentada requiere model, documents, query, top_n e instruct. Los campos query e instruct son cadenas y top_n es un entero que debe proporcionarse explícitamente. El ejemplo publicado utiliza tres textos candidatos, top_n=2 y una instrucción para recuperar pasajes pertinentes que respondan a una consulta de búsqueda web. Utiliza instruct para indicar la relación que importa para la ordenación, manteniendo la pregunta real en query y el material que debe evaluarse en documents.
La guía de la operación indica una longitud máxima de entrada de 30K. Limita los pasajes candidatos al texto necesario para evaluar su relevancia y conserva los títulos o el contexto cercano cuando cambien el significado. Preserva los límites de las fuentes para que un pasaje seleccionado pueda comprobarse en su documento original. El perfil exacto de la solicitud y sus campos obligatorios siguen siendo la base para preparar la entrada.
El resultado estructurado devuelto contiene entradas results con index y relevance_score. El valor index se refiere a la posición del candidato en el array documents original, no a su posición en la lista de resultados ordenados. Conserva el orden devuelto y utiliza cada index para recuperar el texto de entrada correspondiente. Guarda todos los resultados devueltos para que la aplicación pueda examinar juntos los candidatos seleccionados y sus puntuaciones.
Conserva la respuesta JSON completa, incluidos model, el id de respuesta y usage.total_tokens. El texto del documento devuelto puede estar ausente, por lo que debes mantener disponible el array original de candidatos al procesar los índices. Las puntuaciones de relevancia y el uso comunicado tienen funciones distintas: las puntuaciones describen el resultado de la ordenación, mientras que el uso registra la cantidad comunicada para la operación. Ninguno sustituye al pasaje fuente que respalda una respuesta posterior.
Para un flujo de recuperación, utiliza la ordenación para seleccionar los pasajes que el siguiente paso debe examinar o citar. Compara un pasaje seleccionado con la consulta y la instrucción antes de presentar su contenido como prueba. Una posición alta en una lista de resultados identifica un candidato para revisión; la respuesta final de la aplicación debe seguir vinculada al texto real y a su identificador de origen.
Revisa el resultado con consultas representativas y los conjuntos de candidatos utilizados por la aplicación. Comprueba que los índices correspondan a los textos originales previstos, que la ordenación responda a la instrucción proporcionada y que los pasajes elegidos aborden la pregunta. Conserva juntos el selector exacto, la consulta, la instrucción, la correspondencia de candidatos y la respuesta completa para producir un registro reutilizable de selección por relevancia para el siguiente paso de recuperación o de trabajo con documentos.
POST /v1/reranktextstructured| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites qwen3-rerank Condiciones: Selector literal de modelo. | Predeterminado— |
Campodocuments | Tipoarray | RequisitoObligatorio | Valores y límites Condiciones: Pasajes de texto candidatos, conservados en el orden original de entrada. | Predeterminado— |
Campoquery | Tipostring | RequisitoObligatorio | Valores y límites Condiciones: Consulta de relevancia. | Predeterminado— |
Campotop_n | Tipointeger | RequisitoObligatorio | Valores y límites Condiciones: Número solicitado de resultados ordenados por relevancia; no se establece ningún mínimo, máximo ni valor predeterminado que no esté documentado. | Predeterminado— |
Campoinstruct | Tipostring | RequisitoObligatorio | Valores y límites Condiciones: Instrucción que describe la tarea de recuperación de información. | Predeterminado— |
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratomodel, documents, query, top_n, instruct |
Parámetrooptional | Contrato |
Parámetromaterial_types | Contratotext |
Parámetroadditional_properties | Contratotrue |
Ciclo de vida: synchronous
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Unidad de facturación | Cargo |
|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Unidad de facturación— | Cargo Entrada · Tokens de entrada — / 1K tokens Salida · Tokens de salida — / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| Configuracióntoken total | Tabla de tarifas— | Unidad de facturación/ 1K tokens | Cargo Entrada · token total $0.00014 / 1K tokens |
Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
{\n "model": "qwen3-rerank",\n "query": "Which passage discusses text ranking?",\n "documents": [\n "Text ranking orders candidate passages by relevance.",\n "Quantum computing studies computation using quantum systems.",\n "Pretrained language models can improve text ranking."\n ],\n "top_n": 2,\n "instruct": "Given a web search query, retrieve relevant passages that answer the query."\n}Lee los índices y las puntuaciones de relevancia y vincula cada índice con tus documentos originales. Puede faltar el documento reproducido en la respuesta.
Conserva la respuesta original y el id de solicitud tras un envío ambiguo; no lo repitas nunca.
| Campo | Tipo | Significado |
|---|---|---|
Camporesults[].index | Tipointeger | SignificadoÍndice del documento de entrada original correspondiente. |
Camporesults[].relevance_score | Tiponumber | SignificadoPuntuación de relevancia devuelta. |
Campomodel | Tipostring | SignificadoModelo real de la respuesta. |
Campoid | Tipostring | SignificadoIdentificador real de la respuesta. |
Campousage.total_tokens | Tipointeger | SignificadoTotal medido de tokens utilizados para la facturación. |
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónJSON no válido o selección obligatoria de modelo no válida. | Siguiente pasoCorrige la entrada indicada antes de realizar una nueva solicitud. |
Respuesta401 · authentication_error | CondiciónClave API no válida. | Siguiente pasoUsa tu clave API válida de Ailoot. |
Respuesta503 · price_unavailable | CondiciónLos precios estructurados del método o el acceso no están disponibles. | Siguiente pasoConserva la respuesta original; no repitas un envío ambiguo. |
Ailoot Ultra qwen3-rerank
Usa las rutas de método indicadas arriba.