Tools & Embeddings
Document Reranking
Rerank candidate documents by relevance to a query
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());
}
}
Synchronous endpoint — reranks candidate documents by their relevance to a query, commonly used in RAG pipelines. Parameters are passed through directly to the upstream model.
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());
}
}
Request Parameters
Reranker model ID, e.g.,
jina-reranker-v2-base-multilingual.Query text.
Array of candidate documents.
Return the top N most relevant documents.
⌘I
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());
}
}