aisplice

Referência da API

Rerank

Nenhum modelo atende a isto ainda

Nenhum modelo do catálogo oferece esta rota no momento. A página continua disponível como referência.
POST/v1/rerank

Pontua uma lista de documentos candidatos em relação a uma consulta. Os resultados voltam em ordem decrescente de relevância e mantêm o índice original de cada documento.

#Parâmetros da requisição

  • modelstringobrigatório

    Identificador exato do modelo de rerank, conforme o catálogo de modelos atual.

  • querystringobrigatório

    A consulta ou pergunta usada para pontuar os candidatos.

  • documentsstring[]obrigatório

    Trechos candidatos a ordenar. Mantenha a ordem original deles na sua aplicação.

  • top_nintegeropcional

    Número máximo de resultados ordenados a retornar.

  • return_documentsbooleanopcional

    Quando suportado, inclui o texto do documento em cada resultado.

#Erros relacionados

  • 400 invalid_request_errorquery ou documents está ausente, vazio ou não é suportado por este modelo.
  • 401Bearer token inválido ou ausente. Não há error.code neste caminho — verifique o status.
  • 402 insufficient_user_quotaO saldo da carteira não cobre a estimativa pré-reservada.
  • 429Limitação por chave. Corpo vazio; aguarde o Retry-After. Um 429 que traz insufficient_user_quota indica, na verdade, o limite de gastos diário.
  • 503 model_not_foundModelo desconhecido, ou nenhum canal saudável o atende no momento.

Tabela completa de códigos de erro →

#Exemplo de requisição

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
  }'

#Resposta

response.json
{
  "results": [
    { "index": 0, "relevance_score": 0.9821 },
    { "index": 1, "relevance_score": 0.1034 }
  ]
}

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.

AnteriorModelos 3DPróximoPolítica de upload de arquivos