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/rerank

Puntú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

  • modelstringobligatorio

    Identificador exacto del modelo de rerank del catálogo de modelos en vivo.

  • querystringobligatorio

    La consulta de búsqueda o pregunta con la que se puntúan los candidatos.

  • documentsstring[]obligatorio

    Pasajes candidatos que se ordenarán. Conserva su orden original en tu aplicación.

  • top_nintegeropcional

    Número máximo de resultados ordenados que se devuelven.

  • return_documentsbooleanopcional

    Si 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.

Tabla completa de códigos de error →

#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.