curl --request POST \
--url https://api.apiyi.com/v1/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "bge-reranker-v2-m3",
"query": "What are the must-see attractions in Hangzhou?",
"documents": [
"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.",
"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.",
"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."
]
}
EOF
import requests
url = "https://api.apiyi.com/v1/rerank"
payload = {
"model": "bge-reranker-v2-m3",
"query": "What are the must-see attractions in Hangzhou?",
"documents": ["West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.", "The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.", "Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bge-reranker-v2-m3',
query: 'What are the must-see attractions in Hangzhou?',
documents: [
'West Lake is Hangzhou\'s most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.',
'The Bund in Shanghai sits along the Huangpu River and is the city\'s signature landmark.',
'Lingyin Temple, in Hangzhou\'s West Lake district, is one of China\'s best-known Buddhist temples.'
]
})
};
fetch('https://api.apiyi.com/v1/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/rerank",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'bge-reranker-v2-m3',
'query' => 'What are the must-see attractions in Hangzhou?',
'documents' => [
'West Lake is Hangzhou\'s most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.',
'The Bund in Shanghai sits along the Huangpu River and is the city\'s signature landmark.',
'Lingyin Temple, in Hangzhou\'s West Lake district, is one of China\'s best-known Buddhist temples.'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/rerank"
payload := strings.NewReader("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/rerank")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/rerank")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}"
response = http.request(request)
puts response.read_body
{
"results": [
{
"document": {
"text": "West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda."
},
"index": 0,
"relevance_score": 0.97265625
},
{
"document": {
"text": "Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."
},
"index": 2,
"relevance_score": 0.1181640625
}
],
"usage": {
"prompt_tokens": 70,
"total_tokens": 91
}
}
리랭킹
재정렬 API 레퍼런스
bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.
POST
/
v1
/
rerank
Rerank documents: bge-reranker-v2-m3
curl --request POST \
--url https://api.apiyi.com/v1/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data @- <<EOF
{
"model": "bge-reranker-v2-m3",
"query": "What are the must-see attractions in Hangzhou?",
"documents": [
"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.",
"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.",
"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."
]
}
EOF
import requests
url = "https://api.apiyi.com/v1/rerank"
payload = {
"model": "bge-reranker-v2-m3",
"query": "What are the must-see attractions in Hangzhou?",
"documents": ["West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.", "The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.", "Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bge-reranker-v2-m3',
query: 'What are the must-see attractions in Hangzhou?',
documents: [
'West Lake is Hangzhou\'s most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.',
'The Bund in Shanghai sits along the Huangpu River and is the city\'s signature landmark.',
'Lingyin Temple, in Hangzhou\'s West Lake district, is one of China\'s best-known Buddhist temples.'
]
})
};
fetch('https://api.apiyi.com/v1/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.apiyi.com/v1/rerank",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'model' => 'bge-reranker-v2-m3',
'query' => 'What are the must-see attractions in Hangzhou?',
'documents' => [
'West Lake is Hangzhou\'s most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.',
'The Bund in Shanghai sits along the Huangpu River and is the city\'s signature landmark.',
'Lingyin Temple, in Hangzhou\'s West Lake district, is one of China\'s best-known Buddhist temples.'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.apiyi.com/v1/rerank"
payload := strings.NewReader("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1/rerank")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}")
.asString();
require 'uri'
require 'net/http'
url = URI("https://api.apiyi.com/v1/rerank")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"What are the must-see attractions in Hangzhou?\",\n \"documents\": [\n \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.\",\n \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\",\n \"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples.\"\n ]\n}"
response = http.request(request)
puts response.read_body
{
"results": [
{
"document": {
"text": "West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda."
},
"index": 0,
"relevance_score": 0.97265625
},
{
"document": {
"text": "Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."
},
"index": 2,
"relevance_score": 0.1181640625
}
],
"usage": {
"prompt_tokens": 70,
"total_tokens": 91
}
}
오른쪽의 플레이그라운드를 사용하여 엔드포인트를 직접 호출합니다: Bearer sk-your-api-key를
Authorization에 넣은 다음 전송을 누르십시오 — 예시 본문은 이미 채워져 있습니다.
모델 기능, 가격, 측정 데이터와 세 가지 주의 사항은
개요에 있습니다. Recall 크기 조정, chunking 및 임계값 전략은
RAG 튜닝 실전에 있습니다.
index — 문서의 원래 위치입니다. 이는 사용자가 보낸 documents 배열에서의 위치입니다. 이를 사용해
자신의 문서 객체를 조회하십시오; 반환된 text를 기준으로 일치시키지 마십시오.
relevance_score — 범위 0–1. 단일 요청 내에서만 비교 가능합니다. 쿼리 간에는 비교할 수 없으며, 다국어 경우에서는 체계적으로 더 낮습니다. 개요의 임계값 논의를 참조하십시오.
results은 항상 relevance_score 내림차순으로 정렬되며; index 값은 완전하고 고유합니다.
사용량은 prompt_tokens(query
1회 집계 + 모든 문서)와 total_tokens(query
쌍당 집계)에서 읽으십시오; input_tokens / output_tokens는 이 채널에서 항상 0입니다.
이번 라운드에서는 과금에서 어떤 필드가 청구되는지 확인할 수 없었습니다 — 콘솔 청구서를 기준으로 삼으십시오.
cannot unmarshal string into ... top_n of type int
top_n이 문자열이었습니다. 정수를 전달하십시오
400
This model's maximum context length is 8192 tokens
쿼리-문서 쌍 하나가 8192 tokens를 초과했습니다. 청크로 나누어 다시 시도하십시오
401
Invalid token.
잘못된 API 키이거나 Authorization 헤더가 없습니다
429
업스트림 부하가 포화되었습니다
업스트림 쿼터(TPM 20,000 / RPM 120)에 도달했습니다. 두 원인 모두 같은 메시지를 반환합니다: ① 약 4~5개를 초과하는 동시 인플라이트 요청; ② 1분 동안 누적 20,000 tokens 초과(단일 1000-candidate 요청만으로도 이미 초과합니다). 동시 실행 수는 4로 제한하고, 백오프를 추가하며, tokens 예산을 관리하십시오. 이 쿼터는 확대 중입니다 — 더 높은 용량이 필요하면 APIYI 지원팀에 문의하십시오
503
Current group ... has no available channels for model
모델 이름이 대소문자까지 포함해 잘못되었거나, 해당 그룹에 실제로 채널이 없습니다. 먼저 철자를 확인하십시오
503에서는 먼저 모델 이름을 의심하십시오. 요청 본문을 파싱하지 못하면(예를 들어
Content-Type: text/plain), 게이트웨이는 model 필드를 읽지 않고 빈 모델 이름으로 동일한 503을
반환합니다. 이 경우 채널 장애처럼 보이지만 실제로는 그렇지 않습니다.
잘못된 경로는 404를 반환하지 않습니다./rerank와 /v2/rerank(Cohere v2 SDK의
기본값) 모두 HTTP 200과 웹사이트의 HTML 홈페이지를 반환하며, 클라이언트 측에서는
파싱할 수 없는 응답으로 나타납니다. https://api.apiyi.com/v1/rerank만 유효한 경로입니다.
후보 수가 매우 적으면 점수 차이가 극단적입니다(첫 번째는 0.97, 두 번째는 0.12) 그리고
모델의 의사결정 경계가 어디에 있는지 아무것도 알려주지 않습니다. 1020개의 문서를 사용하고,
23개의 의도적인 방해 문서도 포함하십시오. 즉, 주제는 가깝지만 질문에는 답하지 않는 문서입니다.
그래야 귀하의 코퍼스에서의 점수 범위를 볼 수 있고, 어떤 임계값도 그 범위를 기준으로 해야 합니다.
크로스링구얼 테스트에서 낮은 점수는 예상됩니다
영어 문서에 대한 중국어 질의는 정답에 0.003~0.3 정도만 나와도 될 수 있지만,
순서는 맞습니다. 이는 호출이 잘못된 것이 아니라 모델의 특성입니다. 절대값이 아니라 순서로 판단하십시오.
약 2초의 지연시간 하한이 있습니다
후보가 1개뿐이어도 P50에서 약 2초가 걸립니다. 이는 고정된 게이트웨이와 upstream 오버헤드입니다.
후보를 1개에서 100개로 늘려도 P50은 2.0초에서 3.8초로만 증가합니다.
따라서 지연시간을 줄이려고 후보 집합을 줄이지 마십시오. 예상보다 이득이 훨씬 작습니다.
디버깅 중에 쿼터를 소진할 수 있습니다
upstream TPM은 20,000에 불과합니다. 100개 후보로 반복하면 약 15번의 호출만에 1분 예산을 모두 소진하고
429가 반환되기 시작합니다. 대신 10~20개 후보로 디버깅하십시오. 점수 분포를 보기에는 충분하고,
쿼터가 방해하지 않습니다. RAG 튜닝의 쿼터 섹션을 보십시오.
Return the top N results. Omitting it, or passing 0 or a negative number, returns all.
Must be an integer — a string returns 400.
Does not affect usage: every candidate is scored regardless.
Whether to echo the document text in results.
Note: this parameter currently has no effect on this channel — document.text
is always echoed. If response size matters, map results back by index yourself
rather than relying on this flag to trim the payload.
Token usage. This model consumes input tokens only
Show child attributes
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"API易文档中心","description":"企业级专业稳定的AI大模型API中转站,一个令牌、无限模型。支持OpenAI、Claude、Gemini、DeepSeek、Qwen等400+热门AI模型。","colors":{"primary":"#2563eb","light":"#3b82f6","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa","dark":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/dark.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=1f046ae9580247d96549ade642b5ecc4"},"favicon":"https://mintcdn.com/apiyillc/OMY6ItCc2mC1yzgA/logo/logo.webp?fit=max\u0026auto=format\u0026n=OMY6ItCc2mC1yzgA\u0026q=85\u0026s=62a7977ef801070e689df2d0291b9d13","api":{"openapi":["api-reference/nano-banana-2-generate-openapi.yaml","api-reference/nano-banana-2-edit-openapi.yaml","api-reference/nano-banana-2-generate-openapi-en.yaml","api-reference/nano-banana-2-edit-openapi-en.yaml","api-reference/nano-banana-pro-generate-openapi.yaml","api-reference/nano-banana-pro-edit-openapi.yaml","api-reference/nano-banana-pro-generate-openapi-en.yaml","api-reference/nano-banana-pro-edit-openapi-en.yaml","api-reference/gpt-image-2-all-generate-openapi.yaml","api-reference/gpt-image-2-all-edit-openapi.yaml","api-reference/gpt-image-2-all-generate-openapi-en.yaml","api-reference/gpt-image-2-all-edit-openapi-en.yaml","api-reference/gpt-image-2-all-chat-openapi.yaml","api-reference/gpt-image-2-all-chat-openapi-en.yaml","api-reference/gpt-image-2-vip-generate-openapi.yaml","api-reference/gpt-image-2-vip-edit-openapi.yaml","api-reference/gpt-image-2-vip-chat-openapi.yaml","api-reference/gpt-image-2-vip-generate-openapi-en.yaml","api-reference/gpt-image-2-vip-edit-openapi-en.yaml","api-reference/gpt-image-2-vip-chat-openapi-en.yaml"],"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required"}},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首页"},{"href":"https://imagen.apiyi.com","label":"AI出图"},{"href":"https://icover.ai","label":"AI视频"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 集成","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 开发者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"用户口碑 / Wall of Love","items":[{"label":"用户口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"seo":{"indexing":"all"},"icons":{"library":"lucide"},"banner":{"content":"🚀 **gemini-4-argon 和 Nano Banana 2.1 均已上线 | Now Live**:[详情 Details](https://docs.apiyi.com/changelog)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","aistudio"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"languages":[{"language":"zh","href":""},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"href":"en"},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"href":"zh-Hant"},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"href":"ja"},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"href":"ko"},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"href":"ru"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apiyillc","hasAudioNarration":false,"actualSubdomain":"apiyillc","customDomains":["docs.apiyi.com"],"gitSource":{"type":"github","owner":"pdmaker","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae226a4d8e06e769d47ea63","collectionId":"e53ceddc-1e2c-4a37-b7c7-dd23d8cee283","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae226a4d8e06e769d47ea63"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6ae226a4d8e06e769d47ea63","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"zh","tag":"首页","count":213},{"language":"en","tag":"Home","count":213},{"language":"ja","tag":"ホーム","count":213},{"language":"ko","tag":"홈","count":213},{"language":"ru","tag":"Главная","count":213},{"language":"zh-Hant","tag":"首頁","count":213},{"language":"zh","tag":"图片 API(官转)","count":80},{"language":"en","tag":"Image API (Official)","count":80},{"language":"ja","tag":"画像API(公式)","count":80},{"language":"ko","tag":"이미지 API (공식)","count":80},{"language":"ru","tag":"Image API (официальный)","count":80},{"language":"zh-Hant","tag":"圖片 API(官轉)","count":80},{"language":"zh","tag":"公告","count":76},{"language":"en","tag":"Announcements","count":76},{"language":"zh","tag":"AI风向标","count":73},{"language":"en","tag":"AI Radar","count":73},{"language":"zh","tag":"常见问题","count":63},{"language":"en","tag":"FAQ","count":63},{"language":"ja","tag":"FAQ","count":63},{"language":"ko","tag":"FAQ","count":63},{"language":"ru","tag":"FAQ","count":63},{"language":"zh-Hant","tag":"常見問題","count":63},{"language":"zh","tag":"使用场景","count":50},{"language":"en","tag":"Use Cases","count":50},{"language":"ja","tag":"活用例","count":50},{"language":"ko","tag":"활용 사례","count":50},{"language":"ru","tag":"Сценарии использования","count":50},{"language":"zh-Hant","tag":"使用場景","count":50},{"language":"zh","tag":"基础 API","count":47},{"language":"en","tag":"Basic API","count":47},{"language":"ja","tag":"基本API","count":47},{"language":"ko","tag":"기본 API","count":47},{"language":"ru","tag":"Базовый API","count":47},{"language":"zh-Hant","tag":"基礎 API","count":47},{"language":"zh","tag":"视频 API(官转)","count":38},{"language":"en","tag":"Video API (Official)","count":38},{"language":"ja","tag":"動画API(公式)","count":38},{"language":"ko","tag":"동영상 API (공식)","count":38},{"language":"ru","tag":"Video API (официальный)","count":38},{"language":"zh-Hant","tag":"影片 API(官轉)","count":38},{"language":"zh","tag":"模型价格","count":35},{"language":"en","tag":"Model Pricing","count":35},{"language":"ja","tag":"モデル料金","count":35},{"language":"ko","tag":"모델 요금","count":35},{"language":"ru","tag":"Цены на модели","count":35},{"language":"zh-Hant","tag":"模型價格","count":35},{"language":"zh","tag":"文本生成","count":27},{"language":"en","tag":"Text Generation","count":27},{"language":"ja","tag":"テキスト生成","count":27},{"language":"ko","tag":"텍스트 생성","count":27},{"language":"ru","tag":"Генерация текста","count":27},{"language":"zh-Hant","tag":"文本生成","count":27},{"language":"ja","tag":"課金とセキュリティ","count":17},{"language":"ko","tag":"결제 및 보안","count":17},{"language":"ru","tag":"Оплата и безопасность","count":17},{"language":"zh-Hant","tag":"充值與安全","count":17},{"language":"ja","tag":"NanoBananaベストプラクティス","count":15},{"language":"ko","tag":"NanoBanana 모범 사례","count":15},{"language":"ru","tag":"Лучшие практики NanoBanana","count":15},{"language":"zh-Hant","tag":"NanoBanana最佳實踐","count":15}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"models/models.css","content":".mp-layout{display:flex;gap:2.5rem;max-width:1400px;margin:0 auto;padding:2.5rem 1.5rem 4rem;font-size:15px;line-height:1.7;color:rgb(var(--gray-500, 113 115 119))}html.dark .mp-layout{color:rgb(var(--gray-400, 159 161 165))}.mp-rail{display:none}@media (min-width:1024px){.mp-rail{display:block;width:13rem;flex-shrink:0}}.mp-rail-nav{position:sticky;top:9.25rem;font-size:.875rem}.mp-rail-head{font-weight:600;margin:0 0 .375rem;color:rgb(var(--gray-900, 23 25 29))}html.dark .mp-rail-head{color:rgb(var(--gray-200, 223 225 229))}.mp-rail-link{display:block;padding:.22rem 0;color:rgb(var(--gray-500, 113 115 119));text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mp-content a,.mp-content code.mp-ep-rec,.mp-rail-link:hover{color:rgb(var(--primary, 37 99 235))}html.dark .mp-rail-link{color:rgb(var(--gray-400, 159 161 165))}html.dark .mp-content a,html.dark .mp-content code.mp-ep-rec,html.dark .mp-rail-link:hover{color:rgb(var(--primary-light, 59 130 246))}.mp-rail-vendors{max-height:45vh;overflow-y:auto}.mp-mt{margin-top:1rem}.mp-content{min-width:0;flex:1}.mp-content h2,.mp-title{color:rgb(var(--gray-900, 23 25 29))}.mp-title{font-size:2rem;font-weight:700;letter-spacing:-.02em;margin:0 0 .5rem}html.dark .mp-content strong,html.dark .mp-title{color:#fff}.mp-desc{color:rgb(var(--gray-500, 113 115 119));margin:0 0 1.5rem}html.dark .mp-content th,html.dark .mp-desc{color:rgb(var(--gray-400, 159 161 165))}.mp-content h2{font-size:1.375rem;font-weight:600;margin:2.75rem 0 1rem;padding-bottom:.45rem;border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.7);scroll-margin-top:12rem}@media (min-width:1024px){.mp-content h2{scroll-margin-top:16.5rem}}html.dark .mp-content h2{border-color:rgb(255 255 255/.1);color:#fff}.mp-content p,.mp-content ul{margin:.75rem 0}.mp-content ul{padding-left:1.4rem}.mp-content li{margin:.4rem 0}.mp-content strong{color:rgb(var(--gray-900, 23 25 29))}.mp-content a{text-decoration:none}.mp-content a:hover{text-decoration:underline}.mp-content code{font-size:.85em;background:rgb(var(--gray-100, 239 241 245)/.8);border:1px solid rgb(var(--gray-200, 223 225 229)/.7);padding:.1em .35em;border-radius:.375rem}html.dark .mp-content code{background:rgb(255 255 255/.06);border-color:rgb(255 255 255/.1)}.mp-content code.mp-ep-rec{background:rgb(var(--primary, 37 99 235)/.08);border-color:rgb(var(--primary, 37 99 235)/.45);font-weight:600}html.dark .mp-content code.mp-ep-rec{background:rgb(var(--primary-light, 59 130 246)/.14);border-color:rgb(var(--primary-light, 59 130 246)/.5)}.mp-content table{display:block;max-width:100%;overflow-x:auto;border-collapse:collapse;font-size:.875rem;margin:1rem 0 1.5rem}.mp-content td,.mp-content th{padding:.55rem 1.25rem .55rem 0;white-space:nowrap}.mp-content th{text-align:left;font-weight:500;color:rgb(var(--gray-500, 113 115 119));border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.7)}.mp-content td{border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.45)}html.dark .mp-content th{border-color:rgb(255 255 255/.1)}html.dark .mp-content td{border-color:rgb(255 255 255/.07)}.mp-search{display:contents}.mp-search-bar{position:sticky;top:5rem;z-index:20;margin:0 0 1.75rem;background:rgb(var(--background-light, 255 255 255));padding:.75rem 0 .85rem;box-shadow:0 10px 14px -10px rgb(var(--gray-950, 11 13 17)/.28)}@media (min-width:1024px){.mp-search-bar{top:9.25rem}}html.dark .mp-search-bar{background:rgb(var(--background-dark, 10 11 16));box-shadow:0 8px 12px -10px rgb(0 0 0/.7)}.mp-search-label{margin:0 0 .5rem;padding-left:.6rem;border-left:3px solid rgb(var(--primary, 37 99 235));font-size:.9rem;font-weight:600;line-height:1.4;color:rgb(var(--primary, 37 99 235))}html.dark .mp-search-label{border-left-color:rgb(var(--primary-light, 59 130 246));color:rgb(var(--primary-light, 59 130 246))}.mp-search-input{width:100%;box-sizing:border-box;border:1px solid rgb(var(--gray-400, 159 161 165)/.3);border-radius:.75rem;padding:.7rem 1rem .7rem 2.65rem;font-size:.9rem;background-color:rgb(var(--background-light, 255 255 255));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%23717377' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");background-repeat:no-repeat;background-position:.9rem center;color:rgb(var(--gray-900, 23 25 29));outline:0;transition:border-color .15s ease,background-color .15s ease,box-shadow .15s ease}.mp-search-input::placeholder{color:rgb(var(--gray-500, 113 115 119))}.mp-search-input:hover{border-color:rgb(var(--gray-600, 81 83 87)/.3)}.mp-search-input:focus{border-color:rgb(var(--primary, 37 99 235));box-shadow:0 0 0 3px rgb(var(--primary, 37 99 235)/.16)}html.dark .mp-search-input{background-color:rgb(var(--background-dark, 10 11 16));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%239fa1a5' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");border-color:rgb(var(--gray-600, 81 83 87)/.3);color:rgb(var(--gray-100, 239 241 245))}html.dark .mp-search-input::placeholder{color:rgb(255 255 255/.5)}html.dark .mp-search-input:hover{border-color:rgb(var(--gray-500, 113 115 119)/.35)}html.dark .mp-search-input:focus{border-color:rgb(var(--primary-light, 59 130 246));box-shadow:0 0 0 3px rgb(var(--primary-light, 59 130 246)/.22)}.mp-search-empty,.mp-search-meta{color:rgb(var(--gray-500, 113 115 119))}.mp-search-meta{font-size:.75rem;margin:.75rem 0 .25rem}.mp-search-empty{font-size:.875rem;margin-top:.75rem}html.dark .mp-search-empty,html.dark .mp-search-meta{color:rgb(var(--gray-400, 159 161 165))}.mp-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.8125rem}@media (min-width:1024px){.mp-jump{display:none}}"},{"filePath":"styles/agent-prompt.css","content":"div.prompt{border:1.5px solid rgb(var(--primary, 37 99 235)/.35);background:rgb(var(--primary, 37 99 235)/.035);padding:1.25rem 1.25rem 1rem;row-gap:.75rem}html.dark div.prompt{border-color:rgb(var(--primary-light, 59 130 246)/.4);background:rgb(var(--primary-light, 59 130 246)/.06)}div.prompt [data-component-part=prompt-content-wrapper]{width:100%}div.prompt [data-component-part=prompt-actions-wrapper]{width:100%;justify-content:flex-end}div.prompt [data-component-part=prompt-description]{flex:1;font-size:14px;line-height:1.65}div.prompt [data-component-part=prompt-description]>div>*{margin:0}div.prompt [data-component-part=prompt-description]>div>*+*{margin-top:.6rem}div.prompt [data-component-part=prompt-description] strong{font-size:15px;font-weight:650;color:rgb(var(--gray-900, 23 25 29))}html.dark div.prompt [data-component-part=prompt-description] strong{color:#fff}div.prompt [data-component-part=prompt-description]>div>*+p{color:rgb(var(--gray-600, 80 82 86))}html.dark div.prompt [data-component-part=prompt-description]>div>*+p{color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=prompt-description] code{font-size:.85em;background:rgb(var(--gray-100, 239 241 245)/.9);border:1px solid rgb(var(--gray-200, 223 225 229)/.7);padding:.05em .35em;border-radius:.375rem}html.dark div.prompt [data-component-part=prompt-description] code{background:rgb(255 255 255/.06);border-color:rgb(255 255 255/.1)}div.prompt [data-component-part=prompt-description] blockquote{margin:0;padding:.75rem .9rem;font-style:normal;border:1px dashed rgb(var(--gray-300, 191 193 197));border-radius:.6rem;background:rgb(var(--background-light, 255 255 255));font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12.5px;line-height:1.6;color:rgb(var(--gray-600, 80 82 86));overflow-wrap:anywhere;-webkit-mask-image:linear-gradient(to bottom,#000 70%,transparent 100%);mask-image:linear-gradient(to bottom,#000 70%,transparent 100%)}div.prompt [data-component-part=prompt-description] blockquote ol,div.prompt [data-component-part=prompt-description] blockquote p{margin:0}div.prompt [data-component-part=prompt-description] blockquote li{padding:0}div.prompt [data-component-part=prompt-description] blockquote>*+*{margin-top:.5rem}div.prompt [data-component-part=prompt-description] blockquote code{background:0 0;border:0;padding:0;font-size:1em}div.prompt [data-component-part=prompt-description] blockquote a{color:inherit;text-decoration:none;pointer-events:none}html.dark div.prompt [data-component-part=prompt-description] blockquote{border-color:rgb(255 255 255/.15);background:rgb(var(--background-dark, 13 13 13));color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=prompt-action-copy-button]{padding:.6rem 1.25rem;font-size:14px;line-height:20px;font-weight:600;border-radius:.65rem;gap:.45rem;box-shadow:0 1px 2px rgb(0 0 0/.08),0 4px 12px rgb(var(--primary, 37 99 235)/.25)}div.prompt [data-component-part=prompt-action-copy-button]::before{content:\"\";width:16px;height:16px;flex-shrink:0;background:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat}div.prompt [data-component-part=prompt-action-copy-button] svg{width:12px;height:12px}@media (max-width:640px){div.prompt [data-component-part=prompt-actions-wrapper]>*{flex:1}}"}],"page":{"pagePath":"ko/api-capabilities/rerank/rerank-api","slug":"/ko/api-capabilities/rerank/rerank-api","pageMetadata":{"title":"재정렬 API 레퍼런스","sidebarTitle":"플레이그라운드","description":"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ko/api-capabilities/rerank/rerank-api"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,del:`del`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Info,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`오른쪽의 플레이그라운드를 사용하여 엔드포인트를 직접 호출합니다: `,_jsx(_components.code,{children:`Bearer sk-your-api-key`}),`를\n`,_jsx(_components.strong,{children:`Authorization`}),`에 넣은 다음 전송을 누르십시오 — 예시 본문은 이미 채워져 있습니다.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`모델 기능, 가격, 측정 데이터와 세 가지 주의 사항은\n`,_jsx(_components.a,{href:`/ko/api-capabilities/rerank/overview`,children:`개요`}),`에 있습니다. Recall 크기 조정, chunking 및 임계값 전략은\n`,_jsx(_components.a,{href:`/ko/api-capabilities/rerank/rag-best-practices`,children:`RAG 튜닝 실전`}),`에 있습니다.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`매개변수-참조`,children:`매개변수 참조`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`매개변수`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`필수`}),_jsx(_components.th,{children:`비고`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✓`}),_jsxs(_components.td,{children:[`항상 `,_jsx(_components.code,{children:`bge-reranker-v2-m3`}),`입니다. `,_jsx(_components.strong,{children:`대소문자를 구분합니다`}),`(잘못된 이름을 사용하면 404가 아니라 503을 반환합니다)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`query`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✓`}),_jsxs(_components.td,{children:[`검색 쿼리입니다. 빈 문자열을 보내면 400 `,_jsx(_components.code,{children:`query is required`}),`를 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`documents`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`✓`}),_jsxs(_components.td,{children:[`후보입니다. `,_jsx(_components.strong,{children:`평문 문자열 배열만 허용됩니다`}),`. 빈 배열을 보내면 400을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`top_n`})}),_jsx(_components.td,{children:`int`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`상위 N개를 반환합니다. 생략 / `,_jsx(_components.code,{children:`0`}),` / 음수는 모두 전체를 반환하며, 문자열을 보내면 400을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`return_documents`})}),_jsx(_components.td,{children:`bool`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`⚠️ `,_jsx(_components.strong,{children:`이 채널에서는 효과가 없습니다`}),` — 텍스트는 항상 그대로 에코됩니다`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`인식되지 않는 매개변수(`,_jsx(_components.code,{children:`max_chunks_per_doc`}),`, `,_jsx(_components.code,{children:`rank_fields`}),`, `,_jsx(_components.code,{children:`truncate`}),`, …)는 거부되지 않고 조용히 무시됩니다.`]}),`\n`,_jsx(Heading,{level:`2`,id:`응답-참고-사항`,children:`응답 참고 사항`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"document\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"text\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"index\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"relevance_score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.97265625`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"usage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"prompt_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`70`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"total_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`91`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"input_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"output_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`index`}),` — 문서의 `,_jsx(_components.strong,{children:`원래 위치`}),`입니다. 이는 사용자가 보낸 `,_jsx(_components.code,{children:`documents`}),` 배열에서의 위치입니다. 이를 사용해\n자신의 문서 객체를 조회하십시오; 반환된 `,_jsx(_components.code,{children:`text`}),`를 기준으로 일치시키지 마십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`relevance_score`}),` — 범위 0–1. `,_jsx(_components.strong,{children:`단일 요청 내에서만 비교 가능합니다.`}),` 쿼리 간에는 비교할 수 없으며, 다국어 경우에서는 체계적으로 더 낮습니다. `,_jsx(_components.a,{href:`/ko/api-capabilities/rerank/overview`,children:`개요의 임계값 논의`}),`를 참조하십시오.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`results`}),`은 항상 `,_jsx(_components.code,{children:`relevance_score`}),` 내림차순으로 정렬되며; `,_jsx(_components.code,{children:`index`}),` 값은 완전하고 고유합니다.`]}),`\n`,_jsxs(_components.li,{children:[`사용량은 `,_jsx(_components.code,{children:`prompt_tokens`}),`(query\n1회 집계 + 모든 문서)와 `,_jsx(_components.code,{children:`total_tokens`}),`(query\n쌍당 집계)에서 읽으십시오; `,_jsx(_components.code,{children:`input_tokens`}),` / `,_jsx(_components.code,{children:`output_tokens`}),`는 이 채널에서 `,_jsx(_components.strong,{children:`항상 0`}),`입니다.\n이번 라운드에서는 과금에서 어떤 필드가 청구되는지 확인할 수 없었습니다 — 콘솔 청구서를 기준으로 삼으십시오.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`오류-코드`,children:`오류 코드`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`메시지`}),_jsx(_components.th,{children:`원인 및 해결 방법`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`query is required`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`query`}),`이(가) 없거나 빈 문자열입니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`documents is required`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`documents`}),`이(가) 없거나 빈 배열입니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Input should be a valid string`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`documents`}),`에 객체를 전달했습니다. 일반 문자열을 사용하십시오`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`cannot unmarshal string into ... top_n of type int`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`top_n`}),`이 문자열이었습니다. 정수를 전달하십시오`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`This model's maximum context length is 8192 tokens`})}),_jsx(_components.td,{children:`쿼리-문서 쌍 하나가 8192 tokens를 초과했습니다. 청크로 나누어 다시 시도하십시오`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Invalid token.`})}),_jsxs(_components.td,{children:[`잘못된 API 키이거나 `,_jsx(_components.code,{children:`Authorization`}),` 헤더가 없습니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:`업스트림 부하가 포화되었습니다`}),_jsxs(_components.td,{children:[`업스트림 쿼터(`,_jsx(_components.strong,{children:`TPM 20,000 / RPM 120`}),`)에 도달했습니다. 두 원인 모두 같은 메시지를 반환합니다: ① 약 4~5개를 초과하는 동시 인플라이트 요청; ② 1분 동안 누적 20,000 tokens 초과(단일 1000-candidate 요청만으로도 이미 초과합니다). 동시 실행 수는 4로 제한하고, 백오프를 추가하며, tokens 예산을 관리하십시오. 이 쿼터는 확대 중입니다 — 더 높은 용량이 필요하면 APIYI 지원팀에 문의하십시오`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Current group ... has no available channels for model`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`모델 이름이 대소문자까지 포함해 잘못되었거나`}),`, 해당 그룹에 실제로 채널이 없습니다. 먼저 철자를 확인하십시오`]})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`503에서는 먼저 모델 이름을 의심하십시오.`}),` 요청 본문을 파싱하지 못하면(예를 들어\n`,_jsx(_components.code,{children:`Content-Type: text/plain`}),`), 게이트웨이는 `,_jsx(_components.code,{children:`model`}),` 필드를 읽지 않고 빈 모델 이름으로 동일한 503을\n반환합니다. 이 경우 채널 장애처럼 보이지만 실제로는 그렇지 않습니다.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`잘못된 경로는 404를 반환하지 않습니다.`}),` `,_jsx(_components.code,{children:`/rerank`}),`와 `,_jsx(_components.code,{children:`/v2/rerank`}),`(Cohere v2 SDK의\n기본값) 모두 `,_jsx(_components.strong,{children:`HTTP 200과 웹사이트의 HTML 홈페이지`}),`를 반환하며, 클라이언트 측에서는\n파싱할 수 없는 응답으로 나타납니다. `,_jsx(_components.code,{children:`https://api.apiyi.com/v1/rerank`}),`만 유효한 경로입니다.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`디버깅-노트`,children:`디버깅 노트`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`후보 3개만으로 테스트하지 마십시오`,id:`3`,children:_jsxs(_components.p,{children:[`후보 수가 매우 적으면 점수 차이가 극단적입니다(첫 번째는 0.97, 두 번째는 0.12) 그리고\n모델의 의사결정 경계가 어디에 있는지 아무것도 알려주지 않습니다. 10`,_jsx(_components.del,{children:`20개의 문서를 사용하고,\n2`}),`3개의 의도적인 방해 문서도 포함하십시오. 즉, 주제는 가깝지만 질문에는 답하지 않는 문서입니다.\n그래야 `,_jsx(_components.em,{children:`귀하의`}),` 코퍼스에서의 점수 범위를 볼 수 있고, 어떤 임계값도 그 범위를 기준으로 해야 합니다.`]})}),_jsx(Accordion,{title:`크로스링구얼 테스트에서 낮은 점수는 예상됩니다`,id:`%EC%98%81%EC%96%B4-%EB%AC%B8%EC%84%9C%EC%97%90-%EB%8C%80%ED%95%9C-%EC%A4%91%EA%B5%AD%EC%96%B4-%EC%A7%88%EC%9D%98%EB%8A%94-%EC%A0%95%EB%8B%B5%EC%97%90-0.003~0.3-%EC%A0%95%EB%8F%84%EB%A7%8C-%EB%82%98%EC%99%80%EB%8F%84-%EB%90%A0-%EC%88%98-%EC%9E%88%EC%A7%80%EB%A7%8C%2C-%EC%88%9C%EC%84%9C%EB%8A%94-%EB%A7%9E%EC%8A%B5%EB%8B%88%EB%8B%A4.-%EC%9D%B4%EB%8A%94-%ED%98%B8%EC%B6%9C%EC%9D%B4-%EC%9E%98%EB%AA%BB%EB%90%9C-%EA%B2%83%EC%9D%B4-%EC%95%84%EB%8B%88%EB%9D%BC-%EB%AA%A8%EB%8D%B8%EC%9D%98-%ED%8A%B9%EC%84%B1%EC%9E%85%EB%8B%88%EB%8B%A4.-%EC%A0%88%EB%8C%80%EA%B0%92%EC%9D%B4-%EC%95%84%EB%8B%88%EB%9D%BC-%EC%88%9C%EC%84%9C%EB%A1%9C-%ED%8C%90%EB%8B%A8%ED%95%98%EC%8B%AD%EC%8B%9C%EC%98%A4.`,children:_jsxs(_components.p,{children:[`영어 문서에 대한 중국어 질의는 정답에 0.003~0.3 정도만 나와도 될 수 있지만,\n`,_jsx(_components.strong,{children:`순서는 맞습니다`}),`. 이는 호출이 잘못된 것이 아니라 모델의 특성입니다. 절대값이 아니라 순서로 판단하십시오.`]})}),_jsx(Accordion,{title:`약 2초의 지연시간 하한이 있습니다`,id:`2`,children:_jsxs(_components.p,{children:[`후보가 1개뿐이어도 P50에서 약 2초가 걸립니다. 이는 고정된 게이트웨이와 upstream 오버헤드입니다.\n후보를 1개에서 100개로 늘려도 P50은 2.0초에서 3.8초로만 증가합니다.\n따라서 `,_jsx(_components.strong,{children:`지연시간을 줄이려고 후보 집합을 줄이지 마십시오`}),`. 예상보다 이득이 훨씬 작습니다.`]})}),_jsx(Accordion,{title:`디버깅 중에 쿼터를 소진할 수 있습니다`,id:`-1`,children:_jsxs(_components.p,{children:[`upstream TPM은 20,000에 불과합니다. 100개 후보로 반복하면 약 15번의 호출만에 1분 예산을 모두 소진하고\n429가 반환되기 시작합니다. 대신 10~20개 후보로 디버깅하십시오. 점수 분포를 보기에는 충분하고,\n쿼터가 방해하지 않습니다. `,_jsx(_components.a,{href:`/ko/api-capabilities/rerank/rag-best-practices`,children:`RAG 튜닝의 쿼터 섹션`}),`을 보십시오.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"재정렬 API 레퍼런스","sidebarTitle":"플레이그라운드","description":"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ko/api-capabilities/rerank/rerank-api"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"매개변수 참조","slug":"매개변수-참조","depth":2,"children":[]},{"title":"응답 참고 사항","slug":"응답-참고-사항","depth":2,"children":[]},{"title":"오류 코드","slug":"오류-코드","depth":2,"children":[]},{"title":"디버깅 노트","slug":"디버깅-노트","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"rerankBgeRerankerV2M3En","summary":"Rerank documents: bge-reranker-v2-m3","description":"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.","tags":["Rerank"],"security":["09f76291-14df-4aab-aec7-3183c7d8fa69"],"requestBody":"37547f18-f255-4061-b150-4e054e2c1826","responses":{"200":"993d7e23-08af-4c93-ace1-8a6af56ad433","400":"1fad5e34-3625-46a5-8c3d-28581b28709d","401":"efe97c9e-142f-4265-8640-37e71b0abf9c","429":"959e3012-dffe-4e36-9179-20fb24f4f620","503":"fc392fb9-8d95-487f-beb0-42ef169109c4"},"method":"post","type":"path","servers":["dbe24fc4-ae32-4d94-8990-287d14bf160d"],"path":"/v1/rerank","baseUrlOptions":["https://api.apiyi.com"],"title":"Rerank documents: bge-reranker-v2-m3","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","query","documents"],"properties":{"model":{"type":"string","description":"Always bge-reranker-v2-m3 (case-sensitive; a wrong name returns 503)","example":"bge-reranker-v2-m3","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"query":{"type":"string","description":"The search query. An empty string returns 400","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"documents":{"type":"array","description":"Candidate documents. **Plain string array only** — passing Cohere-style\n`[{\"text\": \"...\"}]` objects returns 400. Cannot be empty. Keep to 100 or fewer.\n","items":{"type":"string","uniqueKey":"documents.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"documents","typeLabel":"string[]"},"top_n":{"type":"integer","description":"Return the top N results. Omitting it, or passing 0 or a negative number, returns all.\nMust be an integer — a string returns 400.\n**Does not affect usage**: every candidate is scored regardless.\n","example":2,"uniqueKey":"top_n","typeLabel":"integer"},"return_documents":{"type":"boolean","description":"Whether to echo the document text in results.\n**Note: this parameter currently has no effect on this channel** — `document.text`\nis always echoed. If response size matters, map results back by `index` yourself\nrather than relying on this flag to trim the payload.\n","example":true,"uniqueKey":"return_documents","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"model":"bge-reranker-v2-m3","query":"What are the must-see attractions in Hangzhou?","documents":["West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.","The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.","Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."],"top_n":2,"return_documents":true},"examples":{"Example":{"title":"Example","value":{"model":"bge-reranker-v2-m3","query":"What are the must-see attractions in Hangzhou?","documents":["West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda.","The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.","Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."],"top_n":2,"return_documents":true}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"993d7e23-08af-4c93-ace1-8a6af56ad433":{"description":"Rerank succeeded","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","description":"Sorted by relevance_score, descending","items":{"type":"object","properties":{"index":{"type":"integer","description":"The document's original position in the request's documents array","uniqueKey":"results.items.[INDEX].index","typeLabel":"integer"},"relevance_score":{"type":"number","description":"Relevance score in the 0–1 range (post-sigmoid).\n**It ranks documents within a single query — it is not a confidence value\ncomparable across queries.** Do not apply one fixed threshold everywhere.\n","uniqueKey":"results.items.[INDEX].relevance_score","typeLabel":"number"},"document":{"type":"object","properties":{"text":{"type":"string","uniqueKey":"results.items.[INDEX].document.text","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].document","typeLabel":"object"}},"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"},"usage":{"type":"object","description":"Token usage. This model consumes input tokens only","properties":{"prompt_tokens":{"type":"integer","description":"Total input tokens: the query counted once plus every candidate. Measured ≈ 26.9 × doc count + 7","uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","uniqueKey":"usage.total_tokens","typeLabel":"integer"},"input_tokens":{"type":"integer","description":"Always 0 on this channel — use prompt_tokens instead","uniqueKey":"usage.input_tokens","typeLabel":"integer"},"output_tokens":{"type":"integer","description":"Always 0 on this channel","uniqueKey":"usage.output_tokens","typeLabel":"integer"}},"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"results":[{"document":{"text":"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda."},"index":0,"relevance_score":0.97265625},{"document":{"text":"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."},"index":2,"relevance_score":0.1181640625}],"usage":{"prompt_tokens":70,"total_tokens":91}},"examples":{"Example":{"title":"Example","value":{"results":[{"document":{"text":"West Lake is Hangzhou's most famous attraction, known for Broken Bridge, Su Causeway and Leifeng Pagoda."},"index":0,"relevance_score":0.97265625},{"document":{"text":"Lingyin Temple, in Hangzhou's West Lake district, is one of China's best-known Buddhist temples."},"index":2,"relevance_score":0.1181640625}],"usage":{"prompt_tokens":70,"total_tokens":91}}}},"exampleType":"examples"}},"exampleType":"examples"},"1fad5e34-3625-46a5-8c3d-28581b28709d":{"description":"Bad request: missing query/documents, or a field has the wrong type","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"efe97c9e-142f-4265-8640-37e71b0abf9c":{"description":"Invalid API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"959e3012-dffe-4e36-9179-20fb24f4f620":{"description":"You hit an upstream quota (TPM 20,000 / RPM 120): either more than ~4–5 concurrent in-flight requests, or over 20,000 cumulative tokens in a minute. A single 1000-candidate request already exceeds the latter","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"fc392fb9-8d95-487f-beb0-42ef169109c4":{"description":"Model name misspelled, or no available channel in this group","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"09f76291-14df-4aab-aec7-3183c7d8fa69":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Add the Authorization: Bearer YOUR_API_KEY request header","scopes":[]}}},"servers":{"dbe24fc4-ae32-4d94-8990-287d14bf160d":{"url":"https://api.apiyi.com","description":"Primary endpoint"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Add the Authorization: Bearer YOUR_API_KEY request header","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Add the Authorization: Bearer YOUR_API_KEY request header","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml"},"subdomain":"apiyillc","siteName":"API易文档中心","title":"재정렬 API 레퍼런스 - API易文档中心","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh":{"href":"/api-capabilities/rerank/rerank-api","matchLevel":1},"en":{"href":"/en/api-capabilities/rerank/rerank-api","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/api-capabilities/rerank/rerank-api","matchLevel":1},"ja":{"href":"/ja/api-capabilities/rerank/rerank-api","matchLevel":1},"ko":{"href":"/ko/api-capabilities/rerank/rerank-api","matchLevel":0},"ru":{"href":"/ru/api-capabilities/rerank/rerank-api","matchLevel":1}}},"lastModified":"2026-07-30T15:04:15.451Z","originalFileLocation":"ko/api-capabilities/rerank/rerank-api.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\">\u003cmeta data-mint-head name=\"application-name\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"재정렬 API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head property=\"og:description\" content=\"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=%EB%A6%AC%EB%9E%AD%ED%82%B9\u0026amp;title=%EC%9E%AC%EC%A0%95%EB%A0%AC+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=bge-reranker-v2-m3+%EC%9E%AC%EC%A0%95%EB%A0%AC+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%94%8C%EB%A0%88%EC%9D%B4%EA%B7%B8%EB%9D%BC%EC%9A%B4%EB%93%9C%3A+%2Fv1%2Frerank+%EB%A7%A4%EA%B0%9C%EB%B3%80%EC%88%98%2C+%EC%9D%91%EB%8B%B5+%EA%B5%AC%EC%A1%B0%2C+%EC%98%A4%EB%A5%98+%EC%BD%94%EB%93%9C+%ED%91%9C+%EB%B0%8F+%EB%94%94%EB%B2%84%EA%B9%85+%EB%85%B8%ED%8A%B8.\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=a5b3e2175d9f49ed72b7774b6f4c9935b2aef593b626905e1b23c27a9daec87d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"재정렬 API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=%EB%A6%AC%EB%9E%AD%ED%82%B9\u0026amp;title=%EC%9E%AC%EC%A0%95%EB%A0%AC+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=bge-reranker-v2-m3+%EC%9E%AC%EC%A0%95%EB%A0%AC+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%94%8C%EB%A0%88%EC%9D%B4%EA%B7%B8%EB%9D%BC%EC%9A%B4%EB%93%9C%3A+%2Fv1%2Frerank+%EB%A7%A4%EA%B0%9C%EB%B3%80%EC%88%98%2C+%EC%9D%91%EB%8B%B5+%EA%B5%AC%EC%A1%B0%2C+%EC%98%A4%EB%A5%98+%EC%BD%94%EB%93%9C+%ED%91%9C+%EB%B0%8F+%EB%94%94%EB%B2%84%EA%B9%85+%EB%85%B8%ED%8A%B8.\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=a5b3e2175d9f49ed72b7774b6f4c9935b2aef593b626905e1b23c27a9daec87d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/api-capabilities/rerank/rerank-api.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.apiyi.com/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apiyi.com/en/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.apiyi.com/zh-Hant/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apiyi.com/ja/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apiyi.com/ru/api-capabilities/rerank/rerank-api\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apiyi.com/api-capabilities/rerank/rerank-api\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apiyi.com/#organization\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apiyi.com#website\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api#webpage\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\",\"name\":\"재정렬 API 레퍼런스\",\"description\":\"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\",\"dateModified\":\"2026-07-30T15:04:15.451Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"검색 및 안전\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/text-embedding\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"리랭킹\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"재정렬 API 레퍼런스\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api#apireference\",\"headline\":\"재정렬 API 레퍼런스\",\"name\":\"재정렬 API 레퍼런스\",\"description\":\"bge-reranker-v2-m3 재정렬 API 레퍼런스 및 실시간 플레이그라운드: /v1/rerank 매개변수, 응답 구조, 오류 코드 표 및 디버깅 노트.\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/rerank/rerank-api#webpage\"},\"dateModified\":\"2026-07-30T15:04:15.451Z\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"API易文档中心\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"API易文档中心","nav":{"global":{"anchors":[]},"languages":[{"language":"zh","pages":[{"title":"zh","href":"/api-capabilities/rerank/rerank-api"}]},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"en","href":"/en/api-capabilities/rerank/rerank-api"}]},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"zh-Hant","href":"/zh-Hant/api-capabilities/rerank/rerank-api"}]},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ja","href":"/ja/api-capabilities/rerank/rerank-api"}]},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"tabs":[{"tab":"홈","icon":"house","groups":[{"group":"기초","pages":[{"title":"APIYI - AI 모델 API 허브","sidebarTitle":"소개","icon":"house","href":"/ko"},{"title":"빠른 시작","icon":"rocket","href":"/ko/getting-started"},{"group":"AI 개발자 키트","icon":"terminal","pages":[{"title":"AI 개발자 키트","sidebarTitle":"AI 개발자 키트","icon":"bot","href":"/ko/developer-kit"},{"title":"터미널에 apiyi 명령을 찾을 수 없다고 표시되는 이유는 무엇인가요?","icon":"terminal","href":"/ko/faq/apiyi-cli-command-not-found"}]},{"group":"API 매뉴얼","icon":"book","pages":[{"title":"API 매뉴얼","sidebarTitle":"매뉴얼 개요","icon":"book","href":"/ko/api-manual"},{"title":"API 오류 세부 정보 캡처","sidebarTitle":"오류 캡처","icon":"clipboard-list","href":"/ko/api-manual/error-reporting"},{"group":"API 연동 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"APIYI는 파일 API를 지원하나요?","icon":"file-up","href":"/ko/faq/files-api-not-supported"},{"title":"Base URL을 어떻게 설정하나요? /v1, 루트 도메인, /v1beta의 차이","icon":"link","href":"/ko/faq/base-url-config"},{"title":"모델 API 오류를 어떻게 해결할 수 있습니까?","icon":"alert-triangle","href":"/ko/faq/model-error-troubleshooting"},{"title":"API 동시 실행 수 제한은 무엇입니까?","icon":"gauge","href":"/ko/faq/api-concurrency"}]}]},{"title":"가격","icon":"badge-dollar-sign","href":"/ko/pricing"}]},{"group":"기본 API","icon":"box","pages":[{"group":"모델 정보","icon":"cpu","pages":[{"title":"인기 모델","icon":"database","href":"/ko/api-capabilities/model-info"},{"group":"모델 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"적합한 AI 모델을 선택하는 방법","icon":"compass","href":"/ko/faq/model-selection-guide"},{"title":"공식 웹 앱과 API가 서로 다른 결과를 내는 이유","icon":"layers","href":"/ko/faq/webapp-vs-api-difference"},{"title":"왜 AI 모델은 자신의 버전을 알지 못합니까?","icon":"circle-question-mark","href":"/ko/faq/model-version-identity"}]}]},{"title":"이미지 및 동영상 생성 모델","icon":"palette","href":"/ko/api-capabilities/image-video-models"},{"group":"OpenAI API 호출","icon":"sparkles","pages":[{"title":"OpenAI Responses API 네이티브 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/openai/native"},{"title":"OpenAI Chat Completions 호환 모드","sidebarTitle":"호환 모드","icon":"plug","href":"/ko/api-capabilities/openai/compatible"},{"title":"엔드포인트 선택: GPT-5.4+를 Responses로 마이그레이션하기","sidebarTitle":"엔드포인트 및 마이그레이션","icon":"route","href":"/ko/api-capabilities/openai/responses-migration"},{"title":"OpenAI 호환 모드: 응답 처리","sidebarTitle":"응답 처리","icon":"braces","href":"/ko/api-capabilities/openai/response-handling"},{"title":"OpenAI 호환 모드: 추론 모델 출력","sidebarTitle":"추론 모델 출력","icon":"brain","href":"/ko/api-capabilities/openai/reasoning-models"},{"title":"OpenAI 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/openai/prompt-caching"},{"title":"OpenAI Function Calling 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/openai/function-calling"},{"title":"OpenAI API 웹 검색 가이드","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/openai/web-search"},{"group":"OpenAI 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"APIYI는 OpenAI 빠름/초고속 모드를 지원하나요?","icon":"gauge","href":"/ko/faq/openai-service-tier-fast-mode"},{"title":"콘텐츠 필터링 시 스트리밍 요청과 비스트리밍 요청은 어떻게 다릅니까?","sidebarTitle":"스트리밍 및 콘텐츠 필터링","icon":"shield-half","href":"/ko/faq/streaming-content-filter"},{"title":"OpenAI 모델 거절 응답은 어떤 형태입니까?","icon":"message-square-x","href":"/ko/faq/openai-content-safety-refusal"}]}]},{"group":"Claude 공식","icon":"sparkles","pages":[{"title":"Claude API 호출 기본","sidebarTitle":"Claude API 기본","icon":"sparkles","href":"/ko/api-capabilities/claude"},{"title":"Claude 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/claude-response-handling"},{"title":"Claude 프롬프트 캐싱 가이드","sidebarTitle":"프롬프트 캐싱","icon":"database","href":"/ko/api-capabilities/claude-prompt-caching"},{"title":"Claude Effort \u0026 Thinking 가이드","sidebarTitle":"Effort \u0026 Thinking","icon":"gauge","href":"/ko/api-capabilities/claude-effort-thinking"},{"title":"Claude API 웹 검색 가이드","sidebarTitle":"Claude 웹 검색","icon":"globe","href":"/ko/api-capabilities/claude-web-search"},{"group":"Claude 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Claude가 Qwen이나 DeepSeek이라고 주장하는 이유","icon":"venetian-mask","href":"/ko/faq/claude-identity-confusion"},{"title":"Claude의 Invalid Thinking Signature 오류는 어떻게 해결합니까?","icon":"file-signature","href":"/ko/faq/claude-thinking-signature-invalid"},{"title":"Claude 거절 시 빈 콘텐츠가 반환되는 이유는 무엇입니까?","icon":"message-square-x","href":"/ko/faq/claude-content-safety-refusal"}]}]},{"group":"Gemini 네이티브 호출","icon":"sparkles","pages":[{"title":"Gemini 네이티브 형식 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/gemini/native"},{"title":"Interactions API 대 generateContent","sidebarTitle":"Interactions API 비교","icon":"git-compare","href":"/ko/api-capabilities/gemini/interactions-api"},{"title":"Gemini 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/gemini/response-handling"},{"title":"Gemini 멀티모달 입력 및 코드 실행","sidebarTitle":"멀티모달 및 코드 실행","icon":"images","href":"/ko/api-capabilities/gemini/multimodal"},{"title":"Gemini 암시적 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/gemini/prompt-caching"},{"title":"Gemini 함수 호출 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/gemini/function-calling"},{"title":"Gemini API Web Search 가이드","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/gemini/web-search"},{"title":"Gemini 도구 호출 시 Thought Signature 400 오류를 해결하려면 어떻게 해야 하나요?","icon":"file-signature","href":"/ko/faq/gemini-thought-signature-missing"}]},{"group":"Grok API 호출","icon":"sparkles","pages":[{"title":"Grok 모델 시리즈 가이드","sidebarTitle":"Grok 개요","icon":"rocket","href":"/ko/api-capabilities/grok/overview"},{"title":"Grok 채팅 및 추론 가이드","sidebarTitle":"채팅 \u0026 추론","icon":"message-square","href":"/ko/api-capabilities/grok/chat"},{"title":"Grok 웹 검색 및 X 검색 가이드","sidebarTitle":"웹 및 X 검색","icon":"globe","href":"/ko/api-capabilities/grok/web-search"},{"title":"Grok 코드 실행 및 원격 MCP 가이드","sidebarTitle":"코드 실행 및 MCP","icon":"terminal","href":"/ko/api-capabilities/grok/code-execution-mcp"},{"title":"Grok 멀티 에이전트 모델 가이드","sidebarTitle":"멀티 에이전트 모델","icon":"users","href":"/ko/api-capabilities/grok/multi-agent"},{"title":"Grok 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/grok/prompt-caching"}]},{"group":"텍스트 API 모범 사례","icon":"book-check","pages":[{"title":"장문 출력 실무 가이드","sidebarTitle":"장문 출력","icon":"book-check","href":"/ko/api-capabilities/long-form-output-practices"},{"title":"다중 턴 대화 가이드","sidebarTitle":"다중 턴 대화","icon":"messages-square","href":"/ko/api-capabilities/multi-turn-conversation"},{"group":"텍스트 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"스트리밍 호출과 비스트리밍 호출의 차이점은 무엇입니까?","sidebarTitle":"스트리밍 vs 비스트리밍","icon":"audio-lines","href":"/ko/faq/streaming-vs-non-streaming"},{"title":"max_tokens란 무엇입니까? 설정하지 않으면 어떻게 됩니까?","icon":"sliders-horizontal","href":"/ko/faq/max-tokens"},{"title":"API에 ChatGPT 같은 메모리가 있나요?","icon":"brain","href":"/ko/faq/api-memory"}]}]},{"title":"잔액 조회 API","icon":"wallet","href":"/ko/api-capabilities/balance-query"},{"title":"로그 쿼리 API","icon":"file-text","href":"/ko/api-capabilities/log-query"},{"title":"Token 관리 API","icon":"key","href":"/ko/api-capabilities/token-management"},{"title":"지원 종료된 모델","icon":"triangle-alert","href":"/ko/api-capabilities/deprecated-models"}]},{"group":"이미지 API (공식)","icon":"image","pages":[{"group":"이미지 API 핵심","icon":"book-check","pages":[{"title":"이미지 API 필수 사항 및 모범 사례","sidebarTitle":"반드시 읽기 \u0026 모범 사례","icon":"book-check","href":"/ko/api-capabilities/image-api-best-practices"},{"title":"이미지 API 연결 끊김 문제 해결","sidebarTitle":"연결 끊김","icon":"unplug","href":"/ko/api-capabilities/image-connection-drops"},{"title":"데이터가 도착한 뒤에도 멈춰 있는 이미지 요청","sidebarTitle":"끝에서 멈추는 요청","icon":"hourglass","href":"/ko/api-capabilities/image-tail-stall"},{"title":"이미지 압축 및 출력 해상도","sidebarTitle":"압축 및 해상도","icon":"scaling","href":"/ko/api-capabilities/image-compression-resolution"},{"title":"만족스러운 이미지를 얻는 방법","sidebarTitle":"만족스러운 이미지 얻기","icon":"target","href":"/ko/api-capabilities/image-generation-success-tips"},{"title":"안전성 거부 문제 해결: 절제 실험으로 트리거 단어 찾기","sidebarTitle":"안전성 거부","icon":"shield-alert","href":"/ko/api-capabilities/image-safety-troubleshooting"},{"title":"긴 prompt와 2단계 생성: 32K 제한은 어디에서 비롯되는가","sidebarTitle":"긴 prompt","icon":"text-quote","href":"/ko/api-capabilities/image-long-prompt"},{"title":"고급 이미지 생성: 워크플로와 사실감","sidebarTitle":"고급 워크플로","icon":"workflow","href":"/ko/api-capabilities/image-advanced-workflow"},{"title":"이미지 Prompt Doctor 스킬","sidebarTitle":"Prompt Doctor 스킬","icon":"stethoscope","href":"/ko/api-capabilities/image-prompt-doctor"},{"group":"이미지 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"텍스트와 생성된 이미지를 모두 출력하는 대화형 API가 있습니까?","sidebarTitle":"하나의 API에서 텍스트 + 이미지","icon":"images","href":"/ko/faq/text-and-image-in-one-api"},{"title":"이미지 요청이 결과 없이 멈추지만 로그에 쓰기 실패가 표시되나요?","icon":"hourglass","href":"/ko/faq/image-direct-large-response-stall"},{"title":"프록시 환경에서 이미지 호출이 약 90초 후 끊기나요?","icon":"unplug","href":"/ko/faq/proxy-idle-timeout-disconnect"},{"title":"생성된 이미지가 참조 이미지와 크게 다른 이유는 무엇입니까?","icon":"image","href":"/ko/faq/image-result-differs-from-reference"},{"title":"이미지 콘텐츠가 MIME 유형과 일치하지 않는 오류를 해결하는 방법은 무엇입니까?","icon":"image","href":"/ko/faq/image-mime-type-mismatch-with-query"},{"title":"비동기 이미지 API가 있나요? 결과를 태스크 ID로 조회할 수 있나요?","icon":"image","href":"/ko/faq/image-async-api"}]}]},{"group":"GPT-Image-2.5 / 2 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-Image-2.5 / 2 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5 / 2 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2/image-edit"},{"title":"GPT-Image-2.5 / 2 시리즈 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2/skills"},{"title":"마스크 인페인팅 가이드","sidebarTitle":"마스크 인페인팅","icon":"brush","href":"/ko/api-capabilities/gpt-image-2/mask-editing"},{"title":"GPT-Image 레거시 버전","sidebarTitle":"GPT-Image 레거시","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/gpt-image-2/historical-versions"},{"group":"GPT-Image 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"투명 배경 이미지(PNG 누끼)는 어떻게 생성하나요?","icon":"layers","href":"/ko/faq/image-transparent-background"},{"title":"GPT 이미지 출력 token 수가 왜 이렇게 높은가요?","icon":"calculator","href":"/ko/faq/gpt-image-output-token-calculation"},{"title":"잘못된 API 키로 인해 GPT-Image용 Codex 통합 실패","sidebarTitle":"OpenAI에서 이미지 키 거부","icon":"key-round","href":"/ko/faq/gpt-image-incorrect-api-key-openai"}]}]},{"title":"GPT-image-2.5 / 2 공식 버전 vs 리버스 버전","sidebarTitle":"GPT-image-2.5 / 2 공식 버전 vs 리버스 버전","icon":"scale","href":"/ko/api-capabilities/gpt-image-2/vs-gpt-image-2-all"},{"group":"GPT-Image-2.5-All 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-이미지-2.5-All 이미지 생성/편집","sidebarTitle":"GPT-이미지-2.5-All 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2-all/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-all/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-all/image-edit"},{"title":"GPT-Image-2.5-All Agent 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-all/skills"}]},{"group":"GPT-Image-2.5-VIP 이미지 생성","icon":"expand","pages":[{"title":"GPT-Image-2.5-VIP 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5-VIP 개요","icon":"expand","href":"/ko/api-capabilities/gpt-image-2-vip/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-vip/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-vip/image-edit"},{"title":"GPT-Image-2.5-VIP 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-vip/skills"}]},{"title":"Nano Banana 시리즈 요금 안내","icon":"tag","href":"/ko/api-capabilities/nano-banana-pricing"},{"group":"NanoBanana 모범 사례","icon":"lightbulb","pages":[{"title":"Nano Banana 시리즈 개발자 가이드","icon":"compass","href":"/ko/api-capabilities/nano-banana-dev-guide"},{"title":"사용 필드 및 출력 설명","sidebarTitle":"사용 필드 및 출력 설명","icon":"receipt-text","href":"/ko/api-capabilities/nano-banana-usage-metadata"},{"title":"Gemini 이미지 생성 API 오류 처리 가이드","icon":"triangle-alert","href":"/ko/api-capabilities/gemini-image-error-handling"},{"title":"다중 이미지 융합 테스트 가이드","sidebarTitle":"다중 이미지 융합 테스트","icon":"layers","href":"/ko/api-capabilities/multi-image-fusion-testing"},{"title":"Nano Banana Pro 실패 생성 크레딧 환불 계획","icon":"shield-check","href":"/ko/api-capabilities/nano-banana-pro-guarantee"},{"title":"Nano Banana OSS 그룹","icon":"link","href":"/ko/api-capabilities/nano-banana-oss-group"},{"group":"NB 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Google 모델은 AI Studio에서 실행됩니까, 아니면 Vertex에서 실행됩니까?","icon":"split","href":"/ko/faq/google-upstream-aistudio-vertex"},{"title":"이미지 편집 시 Unable to Process Input Image가 반환되나요?","icon":"image-off","href":"/ko/faq/gemini-empty-inlinedata"},{"title":"Gemini 이미지가 IMAGE_OTHER를 반환하는 이유","sidebarTitle":"IMAGE_OTHER","icon":"image-minus","href":"/ko/faq/gemini-image-other"},{"title":"Gemini 이미지에서 blockReason: OTHER가 반환되는 이유는 무엇입니까?","sidebarTitle":"blockReason: OTHER","icon":"shield-alert","href":"/ko/faq/gemini-image-input-blocked"},{"title":"Nano Banana 이미지 생성 실패의 일반적인 원인","icon":"image-off","href":"/ko/faq/nano-banana-image-failure"},{"title":"Gemini 이미지 API가 NO_IMAGE를 반환하는 이유는 무엇입니까?","icon":"image-off","href":"/ko/faq/gemini-no-image"},{"title":"Nano Banana Pro로 편집한 후 내 이미지가 왜 붉은빛을 띠나요?","icon":"image","href":"/ko/faq/banana-pro-edit-red-cast"},{"title":"Nano Banana Pro에서 의상을 바꿀 때 인쇄 무늬가 왜곡되는 문제를 어떻게 해결하나요?","icon":"shirt","href":"/ko/faq/nano-banana-pro-print-distortion"},{"title":"왜 흰 배경 이미지에 검은 점, 더러운 얼룩, 또는 흐릿한 색 블록이 나타납니까?","icon":"triangle-alert","href":"/ko/faq/white-background-image-artifacts"}]}]},{"group":"Nano Banana 2.1 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2.1 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/gemini-nano-banana-2.1/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/gemini-nano-banana-2.1-generate-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/gemini-nano-banana-2.1/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gemini-nano-banana-2.1-edit-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"image","href":"/ko/api-capabilities/gemini-nano-banana-2.1/image-edit"},{"title":"Nano Banana 2.1 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gemini-nano-banana-2.1/skills"}]},{"group":"Nano Banana Pro 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Pro 이미지 생성","icon":"banana","href":"/ko/api-capabilities/nano-banana-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-pro-generate-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-image/text-to-image"},{"title":"이미지 편집 API 참조","openapi":"api-reference/nano-banana-pro-edit-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-image/image-edit"},{"title":"Nano Banana Pro Agent Skill","icon":"blocks","href":"/ko/api-capabilities/nano-banana-image/skills"}]},{"group":"Nano Banana 2 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-2-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-2-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-2-image/text-to-image"},{"title":"이미지 편집 API 참조","openapi":"api-reference/nano-banana-2-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-2-image/image-edit"},{"title":"Nano Banana 2 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-2-image/skills"}]},{"group":"Nano Banana Lite 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Lite 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-lite-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-lite-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-lite-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/nano-banana-lite-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-lite-image/image-edit"},{"title":"Nano Banana Lite 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-lite-image/skills"}]},{"group":"FLUX 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"FLUX 이미지 생성 및 편집","sidebarTitle":"FLUX 개요","icon":"sparkles","href":"/ko/api-capabilities/flux/overview"},{"title":"텍스트-투-이미지 API 레퍼런스","openapi":"api-reference/flux-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/flux/text-to-image"},{"title":"이미지 편집 API Reference","openapi":"api-reference/flux-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/flux/image-edit"},{"title":"FLUX 과거 버전","sidebarTitle":"과거 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/flux/historical-versions"}]},{"group":"Seedream 5.0 시리즈","icon":"sparkles","pages":[{"title":"Seedream 이미지 생성 및 편집","sidebarTitle":"Seedream 개요","icon":"sparkles","href":"/ko/api-capabilities/seedream-image/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/seedream-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/seedream-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/seedream-image-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/seedream-image/image-edit"},{"title":"Seedream 역대 버전","sidebarTitle":"역대 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/seedream-image/historical-versions"}]},{"group":"Grok Imagine 공식 이미지 생성","icon":"sparkles","pages":[{"title":"Grok Imagine 공식 이미지 생성","sidebarTitle":"Grok Imagine 공식 개요","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/overview"},{"title":"Grok Imagine 공식 텍스트 투 이미지 API 레퍼런스","sidebarTitle":"텍스트 투 이미지","openapi":"api-reference/grok-imagine-image-official-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/text-to-image"}]},{"group":"Grok Imagine 리버스 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"Grok Imagine Reverse 이미지 생성 및 편집","sidebarTitle":"Grok Imagine Reverse 개요","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/grok-imagine-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/grok-imagine-image/image-edit"}]},{"group":"MAI-Image 2.6 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"MAI-Image 2.6 이미지 생성 및 편집","sidebarTitle":"MAI-Image 2.6 개요","icon":"sparkles","href":"/ko/api-capabilities/mai-image/overview"},{"title":"Text-to-Image API 레퍼런스","openapi":"api-reference/mai-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/mai-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/mai-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/mai-image/image-edit"}]},{"title":"이미지 API 통합 실전: 자체 비동기 큐 구축하기","sidebarTitle":"자가 호스팅 비동기 큐","icon":"list-checks","href":"/ko/api-capabilities/image-async-queue"}]},{"group":"동영상 API (공식)","icon":"video","pages":[{"group":"Seedance 2.0 / 2.5 (Volcengine)","icon":"film","pages":[{"title":"Seedance 2.0 / 2.5 동영상 생성","sidebarTitle":"Seedance 2.0 / 2.5 개요","icon":"film","href":"/ko/api-capabilities/seedance2/overview"},{"title":"Seedance 2.0 / 2.5 동영상 생성 API 참조","sidebarTitle":"동영상 생성","openapi":"api-reference/seedance2-video-openapi-en.yaml POST /seedance/api/v3/contents/generations/tasks","icon":"video","href":"/ko/api-capabilities/seedance2/video-generation"},{"title":"Seedance 2.0 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/seedance2/skills"},{"title":"Seedance 2.0 에셋 라이브러리 (캐릭터 일관성 동영상)","sidebarTitle":"에셋 라이브러리","icon":"images","href":"/ko/api-capabilities/seedance2/asset-library"},{"title":"코드에서 에셋 참조 동영상 생성","sidebarTitle":"에셋 참조 가이드","icon":"clapperboard","href":"/ko/api-capabilities/seedance2/asset-reference"},{"title":"에셋 우선: 더 빠르고 안정적인 이미지 및 동영상 입력","sidebarTitle":"에셋 우선 워크플로","icon":"gauge","href":"/ko/api-capabilities/seedance2/asset-first-workflow"},{"group":"SD 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Seedance에서 첫 번째/마지막 프레임과 참조 미디어를 혼용할 수 없다고 표시되는 경우","sidebarTitle":"첫 번째 프레임과 참조 미디어 혼용","icon":"layers","href":"/ko/faq/seedance-first-frame-mixed-with-reference"},{"title":"Seedance에서 invalid image format 오류가 발생하지만 브라우저에서는 링크가 열리는 경우","sidebarTitle":"이미지 링크는 열리지만 실패하는 경우","icon":"link","href":"/ko/faq/seedance-image-url-invalid-format"},{"title":"Seedance 2.5: 참조-동영상 생성과 동영상 편집 비교","icon":"split","href":"/ko/faq/seedance2-reference-vs-edit"},{"title":"제출 후 Seedance 동영상 작업을 취소할 수 있나요?","icon":"video","href":"/ko/faq/seedance-video-task-cancel"},{"title":"task_id로 Seedance 동영상의 실제 비용을 조회하려면 어떻게 해야 하나요?","icon":"receipt","href":"/ko/faq/seedance-task-cost-lookup"},{"title":"Seedance 2.0이 얼굴 참조 이미지를 에셋 라이브러리에 자동 업로드합니까? 딥페이크 필터를 트리거합니까?","icon":"banana","href":"/ko/faq/seedance2-asset-face-reference"},{"title":"Seedance 2.0 / 2.5에서 얼굴 자산이 차단되는 이유","icon":"scan-face","href":"/ko/faq/seedance2-face-asset-whitelist"}]}]},{"group":"Wan3.0 동영상 생성 (Alibaba)","icon":"video","pages":[{"title":"Wan3.0 동영상 생성 (Alibaba Tongyi Wanxiang)","sidebarTitle":"개요","icon":"video","href":"/ko/api-capabilities/wan3/overview"},{"title":"Wan3.0 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/wan3-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan3/video-generation"}]},{"group":"Wan2.7 동영상 생성 (Alibaba)","icon":"videotape","pages":[{"title":"Wan 동영상 생성 (Alibaba Cloud Tongyi Wanxiang)","sidebarTitle":"Wan 개요","icon":"video","href":"/ko/api-capabilities/wan/overview"},{"title":"Wan2.7 텍스트-투-비디오 API 레퍼런스","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/wan-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan/text-to-video"},{"title":"Wan2.7 Image-to-Video API 레퍼런스","sidebarTitle":"Image-to-Video","openapi":"api-reference/wan-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/wan/image-to-video"},{"title":"Wan2.7 Reference-to-Video API 참조","sidebarTitle":"Reference-to-Video","openapi":"api-reference/wan-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/wan/reference-to-video"},{"title":"Wan2.7 동영상 편집 API 레퍼런스","sidebarTitle":"동영상 편집","openapi":"api-reference/wan-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/wan/video-edit"},{"title":"Wan2.7 및 HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/wan/skills"},{"title":"Wan Historical Versions (Wan2.6)","sidebarTitle":"이전 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/wan/historical-versions"}]},{"group":"HappyHorse 동영상 생성 (Alibaba)","icon":"monitor-play","pages":[{"title":"HappyHorse 동영상 생성 (알리바바 클라우드)","sidebarTitle":"HappyHorse 개요","icon":"monitor-play","href":"/ko/api-capabilities/happyhorse/overview"},{"title":"HappyHorse 텍스트-투-비디오 API 레퍼런스","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/happyhorse-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/happyhorse/text-to-video"},{"title":"HappyHorse 이미지-to-동영상 API 레퍼런스","sidebarTitle":"이미지-to-동영상","openapi":"api-reference/happyhorse-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/happyhorse/image-to-video"},{"title":"HappyHorse 레퍼런스-투-비디오 API 레퍼런스","sidebarTitle":"레퍼런스-투-비디오","openapi":"api-reference/happyhorse-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/happyhorse/reference-to-video"},{"title":"HappyHorse 비디오 편집 API 레퍼런스","sidebarTitle":"비디오 편집","openapi":"api-reference/happyhorse-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/happyhorse/video-edit"},{"title":"HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/happyhorse/skills"}]},{"group":"VEO 3.1 (Google)","icon":"clapperboard","pages":[{"title":"VEO 3.1 공식 동영상 생성","sidebarTitle":"VEO 3.1 공식 개요","icon":"video","href":"/ko/api-capabilities/veo-3-1-official/overview"},{"title":"VEO 3.1 공식 텍스트-투-비디오 API","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/veo-3-1-official-text-to-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ko/api-capabilities/veo-3-1-official/text-to-video"},{"title":"VEO 3.1 공식 이미지-투-동영상 API","sidebarTitle":"이미지-투-동영상","openapi":"api-reference/veo-3-1-official-image-to-video-openapi-en.yaml POST /v1/videos","icon":"image","href":"/ko/api-capabilities/veo-3-1-official/image-to-video"},{"title":"VEO 3.1 공식 vs 역방향 채널 비교","sidebarTitle":"공식 vs 역방향","icon":"scale","href":"/ko/api-capabilities/veo-3-1-official/vs-veo-reverse"}]},{"group":"Grok Imagine 동영상 생성 (xAI)","icon":"camera","pages":[{"title":"Grok Imagine 동영상 생성","sidebarTitle":"Grok Imagine 동영상 개요","icon":"video","href":"/ko/api-capabilities/grok-imagine-video/overview"},{"title":"Grok Imagine 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/grok-imagine-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-video/video-generation"}]},{"group":"MiniMax H3 동영상 생성 (자체 호스팅)","icon":"film","pages":[{"title":"MiniMax-H3 동영상 생성","sidebarTitle":"MiniMax-H3 개요","icon":"video","href":"/ko/api-capabilities/minimax-h3/overview"},{"title":"MiniMax-H3 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/minimax-h3-video-openapi-en.yaml POST /hailuo/v2/video_generation","icon":"video","href":"/ko/api-capabilities/minimax-h3/video-generation"}]},{"group":"Oxygen 동영상 생성 (AZ8)","icon":"clapperboard","pages":[{"title":"Oxygen 동영상 생성","sidebarTitle":"Oxygen 개요","icon":"video","href":"/ko/api-capabilities/oxygen/overview"},{"title":"Oxygen 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/oxygen-video-openapi-en.yaml POST /videos","icon":"video","href":"/ko/api-capabilities/oxygen/video-generation"}]}]},{"group":"멀티모달 이해 API","icon":"eye","pages":[{"title":"비전 이해(이미지 인식) API","icon":"eye","href":"/ko/api-capabilities/vision-understanding"},{"title":"동영상 이해 API","icon":"video","href":"/ko/api-capabilities/video-understanding"},{"title":"이미지 이해 요청이 계속 시간 초과됩니다 — 이미지가 너무 큰가요?","icon":"image","href":"/ko/faq/vision-image-too-large"}]},{"group":"텍스트 생성","icon":"file-text","pages":[{"title":"텍스트 생성 (Chat Completions)","icon":"message-square","href":"/ko/api-capabilities/text-generation"},{"group":"Gemini 4 Argon","icon":"sparkles","pages":[{"title":"Gemini 4 Argon 텍스트 생성","sidebarTitle":"Gemini 4 Argon 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-4-argon/overview"}]},{"group":"GPT-6 Astra","icon":"sparkles","pages":[{"title":"GPT-6 Astra 텍스트 생성","sidebarTitle":"GPT-6 Astra 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-6-astra/overview"}]},{"group":"DeepSeek V4 Flash Vision","icon":"eye","pages":[{"title":"DeepSeek V4 Flash 비전","sidebarTitle":"개요","icon":"eye","href":"/ko/api-capabilities/deepseek-v4-flash-vision/overview"},{"title":"DeepSeek V4 Flash Vision Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/chat-completions"},{"title":"DeepSeek V4 Flash Vision Messages API 참조","sidebarTitle":"메시지 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-messages-openapi-en.yaml POST /v1/messages","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/messages"}]},{"group":"DeepSeek V4 Flash","icon":"zap","pages":[{"title":"DeepSeek V4 Flash 텍스트 생성","sidebarTitle":"개요","icon":"zap","href":"/ko/api-capabilities/deepseek-v4-flash/overview"},{"title":"DeepSeek V4 Flash Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash/chat-completions"},{"title":"DeepSeek V4 Flash Responses API 참고서","sidebarTitle":"Responses Playground","openapi":"api-reference/deepseek-v4-flash-responses-openapi-en.yaml POST /v1/responses","icon":"git-fork","href":"/ko/api-capabilities/deepseek-v4-flash/responses"}]},{"group":"DeepSeek Search \u0026 Fetch","icon":"search","pages":[{"title":"DeepSeek 웹 검색 및 Fetch API","sidebarTitle":"개요","icon":"search","href":"/ko/api-capabilities/deepseek-search-fetch/overview"},{"title":"DeepSeek 웹 검색 API 레퍼런스","sidebarTitle":"검색 플레이그라운드","openapi":"api-reference/deepseek-search-openapi-en.yaml POST /v1/tools/search","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/search-api"},{"title":"DeepSeek Web Fetch API 레퍼런스","sidebarTitle":"Fetch 플레이그라운드","openapi":"api-reference/deepseek-fetch-openapi-en.yaml POST /v1/tools/fetch","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/fetch-api"}]},{"group":"Seed 2.1 Turbo","icon":"zap","pages":[{"title":"Seed 2.1 Turbo 텍스트 생성","sidebarTitle":"개요","icon":"message-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/overview"},{"title":"Seed 2.1 Turbo 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/dola-seed-2-1-turbo/chat-completions"},{"title":"Seed 2.1 Turbo Responses API 레퍼런스","sidebarTitle":"Responses 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-responses-openapi-en.yaml POST /v1/responses","icon":"messages-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/responses"}]},{"group":"Gemini Flash 시리즈","icon":"sparkles","pages":[{"title":"Gemini 3.8 Flash 텍스트 생성","sidebarTitle":"Gemini 3.8 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-8-flash/overview"},{"title":"Gemini 3.6 Flash 텍스트 생성","sidebarTitle":"Gemini 3.6 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-6-flash/overview"},{"title":"Gemini 3.6 Flash 네이티브 API 참조","sidebarTitle":"3.6 네이티브 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-native-openapi-en.yaml POST /v1beta/models/gemini-3.6-flash:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/generate-content"},{"title":"Gemini 3.6 Flash 채팅 API 레퍼런스","sidebarTitle":"3.6 채팅 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/chat-completions"}]},{"group":"Gemini 3.5 Flash-Lite","icon":"feather","pages":[{"title":"Gemini 3.5 Flash-Lite 텍스트 생성","sidebarTitle":"개요","icon":"feather","href":"/ko/api-capabilities/gemini-3-5-flash-lite/overview"},{"title":"Gemini 3.5 Flash-Lite 네이티브 API 레퍼런스","sidebarTitle":"네이티브 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-native-openapi-en.yaml POST /v1beta/models/gemini-3.5-flash-lite:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/generate-content"},{"title":"Gemini 3.5 Flash-Lite Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/chat-completions"}]},{"group":"Qwen3 시리즈","icon":"puzzle","pages":[{"title":"Qwen3.8-Max 텍스트 생성","sidebarTitle":"개요","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-8/overview"},{"title":"Qwen3.8-Max Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/qwen-3-8/chat-completions"},{"title":"Qwen3.6 텍스트 모델 시리즈 (레거시)","sidebarTitle":"Qwen3.6 (레거시)","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-6/overview"}]},{"group":"Kimi K3.1 Pro","icon":"moon","pages":[{"title":"Kimi K3.1 Pro 개요","sidebarTitle":"개요","icon":"brain","href":"/ko/api-capabilities/kimi-k3-1/overview"}]},{"title":"Kimi K2.5 텍스트 생성","sidebarTitle":"Kimi K2.5","icon":"bot","href":"/ko/api-capabilities/kimi-k2-5"}]},{"group":"음성 API (공식)","icon":"audio-lines","pages":[{"title":"실시간 음성(웹소켓)","sidebarTitle":"실시간 음성 개요","icon":"audio-lines","href":"/ko/api-capabilities/realtime/overview"}]},{"group":"검색 및 안전","icon":"search","pages":[{"title":"텍스트 임베딩 API","icon":"vector-square","href":"/ko/api-capabilities/text-embedding"},{"title":"실전 임베딩 튜닝","sidebarTitle":"임베딩 튜닝","icon":"sliders-horizontal","href":"/ko/api-capabilities/embedding-best-practices"},{"group":"리랭킹","icon":"list-ordered","pages":[{"title":"bge-reranker-v2-m3 텍스트 리랭킹","sidebarTitle":"개요","description":"bge-reranker-v2-m3는 검색된 후보를 쿼리와 비교해 점수를 매기고 다시 정렬하는 다국어 리랭킹 모델이며, RAG 검색 품질을 가장 저렴하게 실질적으로 향상시키는 방법입니다. APIYI에서 /v1/rerank로 사용할 수 있으며, 1M token당 $0.01입니다.","icon":"list-ordered","href":"/ko/api-capabilities/rerank/overview"},{"title":"재정렬 API 레퍼런스","sidebarTitle":"플레이그라운드","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ko/api-capabilities/rerank/rerank-api"},{"title":"RAG 튜닝 실전","sidebarTitle":"RAG 튜닝","description":"bge-reranker-v2-m3에서 실제로 가치를 얻는 방법: 2단계 검색 구조, 회수할 후보 수, 긴 문서를 청크로 나누는 방법, relevance_score 임계값 설정, 부정 표현 처리, 그리고 LangChain / LlamaIndex / Dify 통합 코드.","icon":"sliders-horizontal","href":"/ko/api-capabilities/rerank/rag-best-practices"}]},{"title":"텍스트 모더레이션","icon":"shield-check","href":"/ko/api-capabilities/text-moderation"}]}]},{"tab":"활용 사례","icon":"layout-grid","pages":[{"title":"활용 사례","href":"/ko/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","pages":[{"title":"FAQ","href":"/ko/faq"}]},{"tab":"실시간 업데이트","icon":"activity","pages":[{"title":"실시간 업데이트","href":"/ko/live"}]},{"tab":"공지사항","icon":"megaphone","pages":[{"title":"공지사항","href":"/ko/changelog"}]},{"tab":"프로모션","icon":"gift","pages":[{"title":"프로모션","href":"/ko/faq/recharge-promotions"}]},{"tab":"모델 요금","icon":"circle-dollar-sign","pages":[{"title":"모델 요금","href":"/ko/models"}]}]},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ru","href":"/ru/api-capabilities/rerank/rerank-api"}]}]},"title":"재정렬 API 레퍼런스 - API易文档中心","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-B-Glu166.js","dist-zbf22OZA.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-Cs6nMGht.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","Page-CBCH2P7b.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","AssistantPageLink-C_fs-y5n.js"]}