跳转到主要内容
POST
/
v1
/
rerank
curl https://www.qingbo.dev/v1/rerank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jina-reranker-v2-base-multilingual",
    "query": "什么是机器学习?",
    "documents": [
      "机器学习是人工智能的一个分支",
      "今天天气很好",
      "深度学习使用神经网络进行特征学习"
    ]
  }'
import requests

response = requests.post(
    "https://www.qingbo.dev/v1/rerank",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "jina-reranker-v2-base-multilingual",
        "query": "什么是机器学习?",
        "documents": [
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习"
        ]
    }
)

print(response.json())
const response = await fetch('https://www.qingbo.dev/v1/rerank', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'jina-reranker-v2-base-multilingual',
    query: '什么是机器学习?',
    documents: [
      '机器学习是人工智能的一个分支',
      '今天天气很好',
      '深度学习使用神经网络进行特征学习'
    ]
  })
});

console.log(await response.json());
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]interface{}{
        "model": "jina-reranker-v2-base-multilingual",
        "query": "什么是机器学习?",
        "documents": []string{
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习",
        },
    }

    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://www.qingbo.dev/v1/rerank", bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
import java.net.http.*;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String payload = """
        {
          "model": "jina-reranker-v2-base-multilingual",
          "query": "什么是机器学习?",
          "documents": [
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习"
          ]
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://www.qingbo.dev/v1/rerank"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}
同步接口 — 对候选文档按与查询文本的相关性进行重新排序,常用于 RAG 检索增强。参数直接透传给上游模型。
curl https://www.qingbo.dev/v1/rerank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jina-reranker-v2-base-multilingual",
    "query": "什么是机器学习?",
    "documents": [
      "机器学习是人工智能的一个分支",
      "今天天气很好",
      "深度学习使用神经网络进行特征学习"
    ]
  }'
import requests

response = requests.post(
    "https://www.qingbo.dev/v1/rerank",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "model": "jina-reranker-v2-base-multilingual",
        "query": "什么是机器学习?",
        "documents": [
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习"
        ]
    }
)

print(response.json())
const response = await fetch('https://www.qingbo.dev/v1/rerank', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'jina-reranker-v2-base-multilingual',
    query: '什么是机器学习?',
    documents: [
      '机器学习是人工智能的一个分支',
      '今天天气很好',
      '深度学习使用神经网络进行特征学习'
    ]
  })
});

console.log(await response.json());
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := map[string]interface{}{
        "model": "jina-reranker-v2-base-multilingual",
        "query": "什么是机器学习?",
        "documents": []string{
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习",
        },
    }

    body, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", "https://www.qingbo.dev/v1/rerank", bytes.NewBuffer(body))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}
import java.net.http.*;
import java.net.URI;

public class Main {
    public static void main(String[] args) throws Exception {
        String payload = """
        {
          "model": "jina-reranker-v2-base-multilingual",
          "query": "什么是机器学习?",
          "documents": [
            "机器学习是人工智能的一个分支",
            "今天天气很好",
            "深度学习使用神经网络进行特征学习"
          ]
        }
        """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://www.qingbo.dev/v1/rerank"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(payload))
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

请求参数

model
string
必填
重排序模型 ID,如 jina-reranker-v2-base-multilingual
query
string
必填
查询文本
documents
string[]
必填
候选文档数组
top_n
integer
返回前 N 个最相关的文档