> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建重排序

创建重排序

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式: Bearer \{\{API 秘钥}}。
</ParamField>

## 请求体

<ParamField body="model" type="string" required={true}>
  要使用的模型名称。
</ParamField>

<ParamField body="query" type="string" required={true}>
  搜索查询。
</ParamField>

<ParamField body="documents" type="string[]" required={true}>
  文档列表。
</ParamField>

<ParamField body="top_n" type="integer" required={false}>
  返回的最相关文档或索引的数量。
</ParamField>

## 响应信息

<ResponseField name="id" type="string" required={true}>
  ID
</ResponseField>

<ResponseField name="results" type="object[]" required={true}>
  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="document" type="object">
      原始文档内容。

      <Expandable title="properties" defaultOpen={false}>
        <ResponseField name="text" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="index" type="integer">
      输入候选文档数组中位置的索引值。
    </ResponseField>

    <ResponseField name="relevance_score" type="number">
      相似度分数。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="usage" type="object">
  Tokens 使用统计。

  <Expandable title="properties" defaultOpen={false}>
    <ResponseField name="completion_tokens" type="integer" required={true}>
      生成的完成中的 tokens 数量。
    </ResponseField>

    <ResponseField name="prompt_tokens" type="integer" required={true}>
      提示中的 tokens 数量。
    </ResponseField>

    <ResponseField name="total_tokens" type="integer" required={true}>
      请求中使用的 tokens 总数（prompt + completion）。
    </ResponseField>
  </Expandable>
</ResponseField>