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

# Créer un réordonnancement

Créer un réordonnancement

## En-têtes de requête

<ParamField header="Content-Type" type="string" required={true}>
  Valeurs énumérées : `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Format d’authentification Bearer : Bearer \{\{API Key}}.
</ParamField>

## Corps de la requête

<ParamField body="model" type="string" required={true}>
  Nom du modèle à utiliser.
</ParamField>

<ParamField body="query" type="string" required={true}>
  Requête de recherche.
</ParamField>

<ParamField body="documents" type="string[]" required={true}>
  Liste des documents.
</ParamField>

<ParamField body="top_n" type="integer" required={false}>
  Nombre de documents ou d’index les plus pertinents à renvoyer.
</ParamField>

## Informations de réponse

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

<ResponseField name="results" type="object[]" required={true}>
  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="document" type="object">
      Contenu du document d’origine.

      <Expandable title="propriétés" defaultOpen={false}>
        <ResponseField name="text" type="string" />
      </Expandable>
    </ResponseField>

    <ResponseField name="index" type="integer">
      Valeur d’index de la position dans le tableau des documents candidats en entrée.
    </ResponseField>

    <ResponseField name="relevance_score" type="number">
      Score de similarité.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="usage" type="object">
  Statistiques d’utilisation des tokens.

  <Expandable title="propriétés" defaultOpen={false}>
    <ResponseField name="completion_tokens" type="integer" required={true}>
      Nombre de tokens dans la complétion générée.
    </ResponseField>

    <ResponseField name="prompt_tokens" type="integer" required={true}>
      Nombre de tokens dans le prompt.
    </ResponseField>

    <ResponseField name="total_tokens" type="integer" required={true}>
      Nombre total de tokens utilisés dans la requête (prompt + completion).
    </ResponseField>
  </Expandable>
</ResponseField>