Referencia de la API
Rerank
Ningún modelo lo admite todavía
Ahora mismo ningún modelo del catálogo admite esta ruta. La página se mantiene como referencia.
POST
/v1/rerankPuntúa una lista de documentos candidatos frente a una consulta. Los resultados se devuelven por relevancia descendente y conservan el índice original de cada documento.
#Parámetros de la solicitud
modelstringobligatorioIdentificador exacto del modelo de rerank del catálogo de modelos en vivo.
querystringobligatorioLa consulta de búsqueda o pregunta con la que se puntúan los candidatos.
documentsstring[]obligatorioPasajes candidatos que se ordenarán. Conserva su orden original en tu aplicación.
top_nintegeropcionalNúmero máximo de resultados ordenados que se devuelven.
return_documentsbooleanopcionalSi se admite, incluye el texto del documento en cada resultado.
#Errores relacionados
- 400 invalid_request_errorquery o documents falta, está vacío o este modelo no lo admite.
- 401Bearer token no válido o ausente. Esta ruta no tiene error.code — compara por el estado.
- 402 insufficient_user_quotaEl saldo de la billetera no cubre la estimación reservada previamente.
- 429Limitación por clave. Cuerpo vacío; espera el Retry-After. Un 429 que sí incluye insufficient_user_quota indica en cambio un límite de gasto diario.
- 503 model_not_foundModelo desconocido, o ningún canal sano lo atiende ahora mismo.
#Ejemplo de solicitud
curl https://www.aisplice.store/v1/rerank \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_RERANK_MODEL",
"query": "What is the capital of France?",
"documents": [
"Paris is the capital of France.",
"Berlin is in Germany."
],
"top_n": 2
}'#Respuesta
response.json
{
"results": [
{ "index": 0, "relevance_score": 0.9821 },
{ "index": 1, "relevance_score": 0.1034 }
]
}¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.