bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.
bge-reranker-v2-m3 — это open-source многоязычная reranking-модель от BAAI. Она решает самый распространенный сбой в системах retrieval: vector search вернул нужные документы, но наверху оказались не те, которые действительно отвечают на вопрос.APIYI предоставляет стандартный /v1/rerank-шлюз — один token, тот же ключ, что и у любой другой модели.
Имя модели: bge-reranker-v2-m3 (с учетом регистра). Шлюз: POST /v1/rerank.
Доступно в группах default и svip.
Все числа на этой странице получены по результатам тестирования APIYI 2026-07-30 (UTC+8), 60+ тестовых случаев.
Реранжировщик — это кросс-энкодер: он конкатенирует ваш запрос с каждым документом-кандидатом, пропускает пару через модель и напрямую выдаёт оценку релевантности.Это принципиально отличается от embedding-модели:
Эмбеддинг (векторный поиск)
Реранжирование
Как вычисляется
Запрос и документ кодируются раздельно, а затем сравниваются по расстоянию
Запрос и документ проходят через модель вместе
Можно ли предварительно проиндексировать?
✅ Векторы документов вычисляются офлайн и хранятся в векторной БД
❌ Для вычислений нужен запрос — предварительно посчитать ничего нельзя
Скорость
Быстро; миллисекунды на миллионах документов
Медленно; масштабируется от числа кандидатов
Точность
Средняя
Высокая
Роль
Recall: извлекать десятки документов из миллионов
Precision: выбирать несколько лучших из десятков
Поэтому он не заменяет векторный поиск — это второй этап, который следует за ним.
Реранжировщик не может построить индекс и не может выполнять извлечение. У него нет векторного
выхода, и он не может обрабатывать документы без запроса. Если вам нужно «поместить мои документы в векторную БД»,
вам нужны text embeddings, а не эта модель.
Те же 10 документов-кандидатов, тот же запрос («Мои API-запросы продолжают возвращать 429 — как это исправить?»), меняется только метод ранжирования:
Метод ранжирования
nDCG@3
P@3
Что попало в топ-3
Только векторное сходство (text-embedding-3-small)
0.53
0.33
Прямой ответ, глоссарий кодов состояния 4xx, уведомление о техобслуживании дата-центра
Плюс bge-reranker-v2-m3
1.00
1.00
Прямой ответ, прямой ответ, объяснение exponential backoff
Векторный поиск поднял в топ-3 глоссарий HTTP-4xx и уведомление о техобслуживании с упоминанием «April 29». Оба материала тематически близки и разделяют лексику с запросом — но ни один не отвечает на него. Реранжировщик опустил оба вниз.В этом и состоит вся ценность: он отделяет «на ту же тему» от «действительно отвечает на вопрос».
bge-reranker-v2-m3 (чувствительно к регистру; при неверном названии возвращается 503)
Архитектура
Cross-encoder, backbone XLM-RoBERTa-large, дообучена на bge-m3
Параметры
~568M (0.6B)
Лимит контекстного окна
8192 token, на пару запрос-документ (измерено: при превышении возвращается 400, без тихого усечения)
Языки
Проверен правильный порядок для китайского, английского, японского, корейского, русского, французского и арабского; кросс-лингвальный retrieval работает
Достаточно дёшево, чтобы не обращать внимания. Реранжирование 100 кандидатов (~2,700 tokens) стоит примерно $0.000027.
Миллион таких вызовов обойдётся в $27. Реранжирование почти никогда не становится узким местом по стоимости в системе RAG —
ограничение здесь — задержка, а не деньги. Подбирайте размер набора кандидатов с учётом задержки, а не затрат.
Семантика использования (измеренная):
prompt_tokens = запрос (учитывается один раз) плюс каждый кандидатный документ. На практике строго линейно: ≈ 26.9 × doc count + 7 (ошибка аппроксимации < 0.31%), так что вы можете предсказывать это на стороне клиента
total_tokens больше, и разрыв растет с ростом числа кандидатов — это согласуется с тем, что запрос учитывается один раз для каждой пары запрос-документ
input_tokens / output_tokens на этом канале всегда 0 — не используйте их
top_n и return_documentsне меняют использование — каждый кандидат оценивается в любом случае
В этот раз не удалось подтвердить по записям тарификации, следуют ли начисления prompt_tokens или
total_tokens (test token не может прочитать эндпоинт баланса аккаунта). При 100 кандидатах эти
два варианта отличаются примерно на 45%. Для задач, чувствительных к стоимости, считайте счёт из консоли
источником истины, а не вычисляйте затраты по полям usage.
curl https://api.apiyi.com/v1/rerank \ -H "Authorization: Bearer $APIYI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "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 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 a well-known Buddhist temple." ], "top_n": 2 }'
import os, requestsresp = requests.post( "https://api.apiyi.com/v1/rerank", headers={"Authorization": f"Bearer {os.environ['APIYI_API_KEY']}"}, json={ "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 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 a well-known Buddhist temple.", ], "top_n": 2, }, timeout=60,).json()for r in resp["results"]: print(f"{r['relevance_score']:.4f} {r['document']['text']}")
const resp = await fetch('https://api.apiyi.com/v1/rerank', { method: 'POST', headers: { Authorization: `Bearer ${process.env.APIYI_API_KEY}`, '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 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 a well-known Buddhist temple.", ], top_n: 2, }),});const data = await resp.json();data.results.forEach((r) => console.log(r.relevance_score, r.document.text));
Ответ:
{ "results": [ { "document": { "text": "West Lake is Hangzhou's most famous attraction..." }, "index": 0, "relevance_score": 0.97265625 }, { "document": { "text": "Lingyin Temple, in Hangzhou's West Lake district..." }, "index": 2, "relevance_score": 0.1181640625 } ], "usage": { "prompt_tokens": 70, "total_tokens": 91 }}
index — это поле, которое имеет значение. Это исходная позиция документа в
массиве documents, который вы отправили. Используйте ее, чтобы найти свой объект документа (ID, URL, метаданные) —
не пытайтесь сопоставлять по возвращенному text.
1. relevance_score — это не показатель уверенности, сопоставимый между запросами
Инстинктивно хочется «просто отфильтровать на 0.5». Измеренные данные показывают, что это ломает работу:
Случай
Диапазон оценок для действительно релевантных документов
Китайский запрос × китайские документы
0.289 – 1.000 (медиана 0.948)
Одноязычные, не китайские (JA/KO/RU/FR/AR)
0.005 – 0.998 (медиана 0.241)
Кросс-лингвальный (ZH ↔ EN)
0.0038 – 0.205
Нерелевантный отвлекающий документ с сильным пересечением по ключевым словам
достигал пика на 0.945
Порог 0.5 отбрасывал бы каждый правильный кросс-лингвальный результат и большинство результатов, занявших второе место
на не китайских языках, при этом допуская документ о ценах на выращивание яблок для
запроса «Apple Inc. выручка за FY2024».Что делать вместо этого: рассматривайте это как ключ сортировки, а не как confidence. Если вам нужно фильтровать, используйте
относительный порог (score >= top1_score × 0.3) или просто берите Top-N и калибруйте на своих
размеченных данных.
2. Отрицание — явная слабость этой модели
Запрос: «Какие достопримечательности стоит посетить зимой?» Два кандидата прямо говорят об
обратном:
Ранг
Оценка
Документ
Действительно релевантно?
#1
0.811
Harbin Ice and Snow World… лучшая зимняя достопримечательность
✅
#2
0.769
Beidaihe… не подходит для зимнего туризма
❌
#3
0.531
Qinghai Lake… не рекомендуется зимой
❌
#4
0.375
Wusong Island… обязательное место для посещения зимой
✅
#5
0.289
Sanya… популярное зимнее направление для отдыха
✅
Модель сопоставила тему «зима + достопримечательности + путешествия» и не обработала отрицание.
nDCG@3 составил всего 0.47.Как смягчить: для запросов с отрицанием, исключением или условиями («без глютена»,
«везде, кроме Beijing», «не применяется к несовершеннолетним») добавляйте LLM-проверку после
reranking — не отдавайте Top-N напрямую пользователям.
3. Длинные документы одновременно размывают релевантность и усиливают шум
Одна и та же совпадающая фраза, дополненная разным количеством нерелевантного заполнителя:
Общая длина
Оценка, совпадение в начале
Оценка, совпадение в конце
528 chars
0.933
0.720
1028 chars
0.931
0.500
4028 chars
0.907
0.351
8028 chars
0.828
0.181
И длина тоже завышает оценки для нерелевантных документов: один и тот же не совпадающий документ получил 0.029
в коротком варианте и 0.121 в дополненном — в 4 раза выше.Как смягчить: разбивайте длинные документы на фрагменты по 200–500 символов перед reranking и берите
самый высокооцененный фрагмент как оценку документа. Chunking — самый эффективный
шаг предварительной обработки для этой модели.
Полный метод настройки — chunking, пороги, подбор recall — описан в RAG tuning in practice.
return_documents не имеет эффекта (измерено 2026-07-30). Независимо от того, передаете ли вы true, false или
вообще опускаете его, document.text возвращается в ответе как есть. Для нагрузок, чувствительных к пропускной способности
(большие наборы кандидатов с длинными документами), ответ получается намного больше ожидаемого — сопоставляйте результаты обратно
по index самостоятельно, вместо того чтобы полагаться на этот флаг.
Неверное имя модели возвращает 503, а не 404. Сообщение выглядит так:
Current group default has no available channels for model xxx. Имя чувствительно к регистру —
BGE-Reranker-v2-M3 считается несуществующей моделью. Если при интеграции вы получаете 503,
проверьте написание, прежде чем предполагать сбой канала.
Внешняя квота — самое жесткое ограничение этой модели: планируйте свои tokenы до интеграции.Внешний сервис (Huawei Cloud MaaS) разрешает для этой модели TPM 20,000 / RPM 120. У модели эмбеддингов BGE-M3
на той же платформе — 1,200,000 TPM — в 60 раз больше.Тестирование разделило два независимых механизма:
Механизм
Измеренное поведение
Около 4–5 параллельных занятых слотов
10 параллельных запросов → 4 успешны; 20 параллельных запросов → 5 успешны (tokenы составляют лишь 3–4% от TPM); 20 последовательных запросов → 20/20 успешны
Окно TPM 20,000 со скользящим обновлением
Срабатывает даже при нулевой параллельности: при последовательной отправке запросов по 1.3K tokenов 8-й возвращает 429 при накопленных 16,093 tokenах, 9 подряд завершаются ошибкой, затем окно сдвигается и система восстанавливается
Запросы сверх лимита слотов отклоняются сразу, а не ставятся в очередь, и обе ошибки возвращают
одинаковое сообщение upstream load saturated — по ответу их нельзя различить, поэтому
вам нужно закладывать это в расчет нагрузки.Рекомендация: ограничьте параллельные запросы до 4, добавьте экспоненциальный backoff и рассчитайте пропускную способность
по таблице ниже.
Если использовать измеренное ≈26.9 tokens/document при TPM 20,000:
Кандидатов на запрос
tokenов на вызов
Теоретический предел
50
673
~29 / мин
100
1,325
~15 / мин
200
2,629
~7 / мин
Это также объясняет, почему один запрос не может содержать слишком много кандидатов: 1000 кандидатов — это
26,867 tokenов, то есть один запрос потребляет 134% всего минутного бюджета, поэтому он гарантированно
получит 429. При 2000 кандидатов это уже 269%.
Расширение квоты уже в процессе. TPM 20,000 выше — это начальное выделение у внешнего сервиса, и
APIYI уже подал заявку на его увеличение. Если ваша нагрузка превышает то, что позволяет таблица,
свяжитесь со службой поддержки APIYI, чтобы пересмотреть квоту внешнего сервиса, вместо того чтобы
уменьшать архитектуру под текущее значение.
/v1/rerank — единственно допустимый путь. Запрос /rerank или /v2/rerank (значение по умолчанию в Cohere v2 SDK)
возвращает HTTP 200 с HTML главной страницы сайта, а не JSON 404 — клиенты видят лишь
непонятную ошибку разбора. Если интеграция сообщает о «неподдающемся разбору ответе», сначала проверьте /v1.
Могу ли я использовать только векторный поиск или реранжирование?
Только векторный поиск: это работает, но точность Top-N заметно хуже (измеренный nDCG@3 падает с
1.00 до 0.53).Реранжирование само по себе: нет. У него нет векторного вывода, и ему нужен набор кандидатов. Оценивать миллионы
документов по одному ни практично, ни экономически оправданно.Стандартная схема двухэтапная: сначала отобрать 50–100 с помощью векторов/BM25 → затем
реранжировать до 3–5 → передать
LLM.
Сколько кандидатов мне нужно отбирать?
Измеренная задержка примерно линейно зависит от числа кандидатов (короткие документы): 10 ≈ 2 с,
100 ≈ 4 с, 500 ≈ 15 с, 1000 ≈ 33 с.50–100 — это оптимальный диапазон. Ниже 20 у реранжировщика остается не так много ошибок в порядке,
которые нужно исправлять. Выше 200 задержка уже начинает мешать интерактивности, а хвост списка
кандидатов все равно редко содержит ответ.Бюджет тоже важен: 100 кандидатов — это ~1,325 token, поэтому TPM 20,000 позволяет только ~15 поисков в
минуту. Удвойте число кандидатов — и вы вдвое снизите пропускную способность: число кандидатов — это
не только решение по качеству, но и решение по емкости.
Могу ли я направить на него Cohere или Jina SDK?
cohere SDK v2 не работает как есть: он нацелен на /v2/rerank, который возвращает HTML
главной страницы вместо JSON, поэтому SDK выдает ошибку разбора.Названия параметров (query / documents / top_n / return_documents) действительно соответствуют Cohere Rerank
v1, но documentsпринимает только массив строк ([{"text": "..."}] возвращает 400), а
в ответе нет полей id / meta. Проще всего обернуть HTTP-вызов самостоятельно —
Практическая настройка RAG содержит готовые
адаптеры для LangChain и LlamaIndex.Проверенные рабочие клиенты: обычный requests POST ✅ и запасной вариант через SDK openaiclient.post("/rerank", ...) ✅.
Могу ли я кэшировать результаты?
Да, и это очень стабильно. Повторение идентичного запроса 10 раз дает побитово идентичный результат (нулевой
дрейф). Дрейф порядка ~3.7e-4 появляется только когда вы перемешиваете порядок кандидатов (дрожание
батчинга bf16), и порядок не меняется.Привязывайте кэш к normalised query + ordered hash of document contents. Поскольку порядок
вносит этот небольшой дрейф, не рассматривайте relevance_score как ключ идемпотентности.
Что происходит после 8192 token?
Вы получите 400 с This model's maximum context length is 8192 tokens. Он не обрезает
данные молча. Лимит применяется к каждой паре запрос-документ, а не к запросу целиком — один
запрос с 400 documents × 1000 characters (330K tokens total) возвращается нормально.
{"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":"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":"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":"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":"ru/api-capabilities/rerank/overview","slug":"/ru/api-capabilities/rerank/overview","pageMetadata":{"title":"bge-reranker-v2-m3 Переранжирование текста","sidebarTitle":"Обзор","description":"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.","icon":"list-ordered","href":"/ru/api-capabilities/rerank/overview"},"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 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\"\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`,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,CodeGroup,Heading,Info,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,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:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`bge-reranker-v2-m3`}),` — это open-source многоязычная reranking-модель от BAAI. Она решает самый распространенный сбой в системах retrieval: `,_jsx(_components.strong,{children:`vector search вернул нужные документы, но наверху оказались не те, которые действительно отвечают на вопрос.`})]}),`\n`,_jsxs(_components.p,{children:[`APIYI предоставляет стандартный `,_jsx(_components.code,{children:`/v1/rerank`}),`-шлюз — один token, тот же ключ, что и у любой другой модели.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Имя модели`}),`: `,_jsx(_components.code,{children:`bge-reranker-v2-m3`}),` (с учетом регистра). `,_jsx(_components.strong,{children:`Шлюз`}),`: `,_jsx(_components.code,{children:`POST /v1/rerank`}),`.\nДоступно в группах `,_jsx(_components.code,{children:`default`}),` и `,_jsx(_components.code,{children:`svip`}),`.\nВсе числа на этой странице получены по результатам тестирования APIYI 2026-07-30 (UTC+8), 60+ тестовых случаев.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`что-это-такое-и-когда-это-использовать`,children:`Что это такое и когда это использовать`}),`\n`,_jsxs(_components.p,{children:[`Реранжировщик — это `,_jsx(_components.strong,{children:`кросс-энкодер`}),`: он конкатенирует ваш запрос с каждым документом-кандидатом, пропускает пару через модель и напрямую выдаёт оценку релевантности.`]}),`\n`,_jsx(_components.p,{children:`Это принципиально отличается от embedding-модели:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Эмбеддинг (векторный поиск)`}),_jsx(_components.th,{children:`Реранжирование`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Как вычисляется`}),_jsxs(_components.td,{children:[`Запрос и документ кодируются `,_jsx(_components.strong,{children:`раздельно`}),`, а затем сравниваются по расстоянию`]}),_jsxs(_components.td,{children:[`Запрос и документ проходят через модель `,_jsx(_components.strong,{children:`вместе`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Можно ли предварительно проиндексировать?`}),_jsx(_components.td,{children:`✅ Векторы документов вычисляются офлайн и хранятся в векторной БД`}),_jsx(_components.td,{children:`❌ Для вычислений нужен запрос — предварительно посчитать ничего нельзя`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Скорость`}),_jsx(_components.td,{children:`Быстро; миллисекунды на миллионах документов`}),_jsx(_components.td,{children:`Медленно; масштабируется от числа кандидатов`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Точность`}),_jsx(_components.td,{children:`Средняя`}),_jsx(_components.td,{children:`Высокая`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Роль`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Recall`}),`: извлекать десятки документов из миллионов`]}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Precision`}),`: выбирать несколько лучших из десятков`]})]})]})]}),`\n`,_jsx(_components.p,{children:`Поэтому он не заменяет векторный поиск — это второй этап, который следует за ним.`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Реранжировщик `,_jsx(_components.strong,{children:`не может построить индекс и не может выполнять извлечение`}),`. У него нет векторного\nвыхода, и он не может обрабатывать документы без запроса. Если вам нужно «поместить мои документы в векторную БД»,\nвам нужны `,_jsx(_components.a,{href:`/ru/api-capabilities/text-embedding`,children:`text embeddings`}),`, а не эта модель.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`сравнение-на-конкретном-примере`,children:`Сравнение на конкретном примере`}),`\n`,_jsx(_components.p,{children:`Те же 10 документов-кандидатов, тот же запрос («Мои API-запросы продолжают возвращать 429 — как это исправить?»), меняется только метод ранжирования:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Метод ранжирования`}),_jsx(_components.th,{children:`nDCG@3`}),_jsx(_components.th,{children:`P@3`}),_jsx(_components.th,{children:`Что попало в топ-3`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Только векторное сходство (`,_jsx(_components.code,{children:`text-embedding-3-small`}),`)`]}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.53`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.33`}),_jsxs(_components.td,{children:[`Прямой ответ, `,_jsx(_components.strong,{children:`глоссарий кодов состояния 4xx`}),`, `,_jsx(_components.strong,{children:`уведомление о техобслуживании дата-центра`})]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Плюс `,_jsx(_components.code,{children:`bge-reranker-v2-m3`})]}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`1.00`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`1.00`})}),_jsx(_components.td,{children:`Прямой ответ, прямой ответ, объяснение exponential backoff`})]})]})]}),`\n`,_jsx(_components.p,{children:`Векторный поиск поднял в топ-3 глоссарий HTTP-4xx и уведомление о техобслуживании с упоминанием «April 29». Оба материала тематически близки и разделяют лексику с запросом — но ни один не отвечает на него. Реранжировщик опустил оба вниз.`}),`\n`,_jsxs(_components.p,{children:[`В этом и состоит вся ценность: `,_jsx(_components.strong,{children:`он отделяет «на ту же тему» от «действительно отвечает на вопрос».`})]}),`\n`,_jsx(Heading,{level:`2`,id:`информация-о-модели`,children:`Информация о модели`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Property`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Название модели`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`bge-reranker-v2-m3`}),` (чувствительно к регистру; при неверном названии возвращается 503)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Архитектура`})}),_jsx(_components.td,{children:`Cross-encoder, backbone XLM-RoBERTa-large, дообучена на bge-m3`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Параметры`})}),_jsx(_components.td,{children:`~568M (0.6B)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Лимит контекстного окна`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`8192 token, на пару запрос-документ`}),` (измерено: при превышении возвращается 400, без тихого усечения)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Языки`})}),_jsx(_components.td,{children:`Проверен правильный порядок для китайского, английского, японского, корейского, русского, французского и арабского; кросс-лингвальный retrieval работает`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Эндпоинт`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/rerank`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Группы`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`default`}),`, `,_jsx(_components.code,{children:`svip`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Источник`})}),_jsx(_components.td,{children:`Huawei Cloud ModelArts (официальный passthrough)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Лицензия`})}),_jsx(_components.td,{children:`Apache 2.0`})]})]})]}),`\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:`Цена`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Вход`}),_jsx(_components.td,{children:`$0.01 / 1M tokens`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Выход`}),_jsx(_components.td,{children:`Нет (эта модель не выдаёт output tokens)`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Достаточно дёшево, чтобы не обращать внимания.`}),` Реранжирование 100 кандидатов (~2,700 tokens) стоит примерно $0.000027.\nМиллион таких вызовов обойдётся в $27. Реранжирование почти никогда не становится узким местом по стоимости в системе RAG —\n`,_jsx(_components.strong,{children:`ограничение здесь — задержка, а не деньги`}),`. Подбирайте размер набора кандидатов с учётом задержки, а не затрат.`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Семантика использования`}),` (измеренная):`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`prompt_tokens`}),` = запрос (учитывается один раз) плюс каждый кандидатный документ. На практике строго линейно: `,_jsx(_components.code,{children:`≈ 26.9 × doc count + 7`}),` (ошибка аппроксимации \u003c 0.31%), так что вы можете предсказывать это на стороне клиента`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`total_tokens`}),` больше, и разрыв растет с ростом числа кандидатов — это согласуется с тем, что запрос учитывается один раз для каждой пары запрос-документ`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`input_tokens`}),` / `,_jsx(_components.code,{children:`output_tokens`}),` на этом канале `,_jsx(_components.strong,{children:`всегда 0`}),` — не используйте их`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`top_n`}),` и `,_jsx(_components.code,{children:`return_documents`}),` `,_jsx(_components.strong,{children:`не меняют использование`}),` — каждый кандидат оценивается в любом случае`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`В этот раз `,_jsxs(_components.strong,{children:[`не удалось подтвердить по записям тарификации, следуют ли начисления `,_jsx(_components.code,{children:`prompt_tokens`}),` или\n`,_jsx(_components.code,{children:`total_tokens`})]}),` (test token не может прочитать эндпоинт баланса аккаунта). При 100 кандидатах эти\nдва варианта отличаются примерно на 45%. Для задач, чувствительных к стоимости, считайте счёт из консоли\nисточником истины, а не вычисляйте затраты по полям `,_jsx(_components.code,{children:`usage`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`минимальный-вызов`,children:`Минимальный вызов`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`13`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.apiyi.com/v1/rerank`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$APIYI_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\": \"bge-reranker-v2-m3\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"query\": \"What are the must-see attractions in Hangzhou?\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"documents\": [`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"West Lake is Hangzhou'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'s most famous attraction, known for Broken Bridge and Leifeng Pagoda.\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The Bund in Shanghai sits along the Huangpu River and is the city'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'s signature landmark.\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Lingyin Temple, in Hangzhou'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'s West Lake district, is a well-known Buddhist temple.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"top_n\": 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`20`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os, requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`resp `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.apiyi.com/v1/rerank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Bearer `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'APIYI_API_KEY'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bge-reranker-v2-m3\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"query\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"What are the must-see attractions in Hangzhou?\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"documents\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge and Leifeng Pagoda.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Lingyin Temple, in Hangzhou's West Lake district, is a well-known Buddhist temple.\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"top_n\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_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:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`60`}),_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:`).json()`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` r `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`in`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resp[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`r[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'relevance_score'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:.4f}`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` {`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`r[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'document'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'text'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node.js`,numberOfLines:`20`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`20`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` resp`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'https://api.apiyi.com/v1/rerank'`}),_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\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_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\":`#9CDCFE`},children:` headers:`}),_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\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `Bearer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`process`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`APIYI_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_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\":`#9CDCFE`},children:` model:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'bge-reranker-v2-m3'`}),_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\":`#9CDCFE`},children:` query:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'What are the must-see attractions in Hangzhou?'`}),_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\":`#9CDCFE`},children:` documents:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"West Lake is Hangzhou's most famous attraction, known for Broken Bridge and Leifeng Pagoda.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The Bund in Shanghai sits along the Huangpu River and is the city's signature landmark.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Lingyin Temple, in Hangzhou's West Lake district, is a well-known Buddhist temple.\"`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` top_n:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 2`}),_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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` data`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` resp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_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\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`results`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`forEach`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`((`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`r`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`r`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`relevance_score`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`r`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`document`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`text`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`));`})]}),`\n`]})})})]}),`\n`,_jsx(_components.p,{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:`\"West Lake is Hangzhou's most famous attraction...\"`}),_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`,_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:`\"Lingyin Temple, in Hangzhou's West Lake district...\"`}),_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:`2`}),_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.1181640625`}),_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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`index`}),` — это поле, которое имеет значение.`]}),` Это `,_jsx(_components.strong,{children:`исходная позиция`}),` документа в\nмассиве `,_jsx(_components.code,{children:`documents`}),`, который вы отправили. Используйте ее, чтобы найти свой объект документа (ID, URL, метаданные) —\nне пытайтесь сопоставлять по возвращенному `,_jsx(_components.code,{children:`text`}),`.`]})}),`\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:`Тип`}),_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:`с учетом регистра`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`query`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✓`}),_jsx(_components.td,{children:`Поисковый запрос. Пустая строка возвращает 400`})]}),_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:[`Возвращает top N. Если параметр опущен / `,_jsx(_components.code,{children:`0`}),` / отрицательный, возвращается все. Не влияет на использование`]})]}),_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`,_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:`Результат`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Китайский семантический ранжирование`}),_jsx(_components.td,{children:`✅ nDCG@3 = 1.00`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Устойчивость к ловушкам по ключевым словам`}),_jsx(_components.td,{children:`✅ Top-2 корректен, но отвлекающий вариант все еще может получить очень высокий балл (см. ниже)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Межъязыковой режим (ZH ↔ EN)`}),_jsx(_components.td,{children:`✅ Порядок корректен, но абсолютные оценки падают на 1–2 порядка`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Многоязычный режим (JA / KO / RU / FR / AR)`}),_jsx(_components.td,{children:`✅ Все пять вариантов отсортированы правильно`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Понимание отрицания`})}),_jsxs(_components.td,{children:[`❌ `,_jsx(_components.strong,{children:`Явная слабость`}),`, nDCG@3 = 0.47 (см. ниже)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Детерминизм`}),_jsx(_components.td,{children:`✅ Повторение запроса 10× дает бит-в-бит идентичный результат; при перемешивании кандидатов дрейф составляет лишь 3.7e-4`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Согласованность для дублирующихся документов`}),_jsx(_components.td,{children:`✅ Идентичные документы получают бит-в-бит идентичные оценки`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Максимум кандидатов на запрос`}),_jsxs(_components.td,{children:[`✅ 2000 работает на практике; `,_jsx(_components.strong,{children:`держите значение ≤ 100`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Максимальная длина документа`}),_jsx(_components.td,{children:`8192 tokens на пару; при превышении возвращается 400 (без тихой усечки)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Квота upstream`})}),_jsx(_components.td,{children:`⚠️ TPM 20,000 / RPM 120, примерно 4–5 параллельных слотов; около 15 поисков/мин при 100 кандидатах (см. ниже)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`return_documents: false`})}),_jsx(_components.td,{children:`❌ Параметр игнорируется`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`три-вещи-которые-вы-должны-знать`,children:`Три вещи, которые вы должны знать`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`1. relevance_score — это не показатель уверенности, сопоставимый между запросами`,icon:`triangle-alert`,id:`1-relevance-score-eto-ne-pokazatel-uverennosti-sopostavimiy-mezhdu-zaprosami`,children:[_jsxs(_components.p,{children:[`Инстинктивно хочется «просто отфильтровать на 0.5». `,_jsx(_components.strong,{children:`Измеренные данные показывают, что это ломает работу:`})]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Случай`}),_jsx(_components.th,{children:`Диапазон оценок для действительно релевантных документов`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Китайский запрос × китайские документы`}),_jsx(_components.td,{children:`0.289 – 1.000 (медиана 0.948)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Одноязычные, не китайские (JA/KO/RU/FR/AR)`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`0.005 – 0.998`}),` (медиана 0.241)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Кросс-лингвальный (ZH ↔ EN)`})}),_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`0.0038 – 0.205`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Нерелевантный отвлекающий документ с сильным пересечением по ключевым словам`}),_jsxs(_components.td,{children:[`достигал пика на `,_jsx(_components.strong,{children:`0.945`})]})]})]})]}),_jsxs(_components.p,{children:[`Порог 0.5 `,_jsx(_components.strong,{children:`отбрасывал бы каждый правильный кросс-лингвальный результат`}),` и большинство результатов, занявших второе место\nна не китайских языках, при этом `,_jsx(_components.strong,{children:`допуская`}),` документ о ценах на выращивание яблок для\nзапроса «Apple Inc. выручка за FY2024».`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Что делать вместо этого`}),`: рассматривайте это как ключ сортировки, а не как confidence. Если вам нужно фильтровать, используйте\nотносительный порог (`,_jsx(_components.code,{children:`score >= top1_score × 0.3`}),`) или просто берите Top-N и калибруйте на своих\nразмеченных данных.`]})]}),_jsxs(Accordion,{title:`2. Отрицание — явная слабость этой модели`,icon:`circle-x`,id:`2-otritsanie-yavnaya-slabost-etoy-modeli`,children:[_jsx(_components.p,{children:`Запрос: «Какие достопримечательности стоит посетить зимой?» Два кандидата прямо говорят об\nобратном:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Ранг`}),_jsx(_components.th,{children:`Оценка`}),_jsx(_components.th,{children:`Документ`}),_jsx(_components.th,{children:`Действительно релевантно?`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`#1`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.811`}),_jsx(_components.td,{children:`Harbin Ice and Snow World… лучшая зимняя достопримечательность`}),_jsx(_components.td,{children:`✅`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`#2`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.769`}),_jsxs(_components.td,{children:[`Beidaihe… `,_jsx(_components.strong,{children:`не подходит для зимнего туризма`})]}),_jsx(_components.td,{children:`❌`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`#3`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.531`}),_jsxs(_components.td,{children:[`Qinghai Lake… `,_jsx(_components.strong,{children:`не рекомендуется зимой`})]}),_jsx(_components.td,{children:`❌`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`#4`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.375`}),_jsx(_components.td,{children:`Wusong Island… обязательное место для посещения зимой`}),_jsx(_components.td,{children:`✅`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`#5`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.289`}),_jsx(_components.td,{children:`Sanya… популярное зимнее направление для отдыха`}),_jsx(_components.td,{children:`✅`})]})]})]}),_jsxs(_components.p,{children:[`Модель сопоставила тему «зима + достопримечательности + путешествия» и `,_jsx(_components.strong,{children:`не обработала отрицание`}),`.\nnDCG@3 составил всего 0.47.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Как смягчить`}),`: для запросов с отрицанием, исключением или условиями («без глютена»,\n«везде, кроме Beijing», «не применяется к несовершеннолетним») добавляйте LLM-проверку после\nreranking — не отдавайте Top-N напрямую пользователям.`]})]}),_jsxs(Accordion,{title:`3. Длинные документы одновременно размывают релевантность и усиливают шум`,icon:`scissors`,id:`3-dlinnye-dokumenty-odnovremenno-razmyvayut-relevantnost-i-usilivayut-shum`,children:[_jsx(_components.p,{children:`Одна и та же совпадающая фраза, дополненная разным количеством нерелевантного заполнителя:`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Общая длина`}),_jsxs(_components.th,{children:[`Оценка, совпадение в `,_jsx(_components.strong,{children:`начале`})]}),_jsxs(_components.th,{children:[`Оценка, совпадение в `,_jsx(_components.strong,{children:`конце`})]})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`528 chars`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.933`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.720`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`1028 chars`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.931`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.500`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`4028 chars`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.907`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.351`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`8028 chars`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.828`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0.181`})]})]})]}),_jsxs(_components.p,{children:[`И `,_jsx(_components.strong,{children:`длина тоже завышает оценки для нерелевантных документов`}),`: один и тот же не совпадающий документ получил 0.029\nв коротком варианте и 0.121 в дополненном — в 4 раза выше.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Как смягчить`}),`: разбивайте длинные документы на фрагменты по 200–500 символов перед reranking и берите\nсамый высокооцененный фрагмент как оценку документа. Chunking — самый эффективный\nшаг предварительной обработки для этой модели.`]})]})]}),`\n`,_jsxs(_components.p,{children:[`Полный метод настройки — chunking, пороги, подбор recall — описан в `,_jsx(_components.a,{href:`/ru/api-capabilities/rerank/rag-best-practices`,children:`RAG tuning in practice`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`известные-проблемы`,children:`Известные проблемы`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`return_documents`}),` не имеет эффекта`]}),` (измерено 2026-07-30). Независимо от того, передаете ли вы `,_jsx(_components.code,{children:`true`}),`, `,_jsx(_components.code,{children:`false`}),` или\nвообще опускаете его, `,_jsx(_components.code,{children:`document.text`}),` возвращается в ответе как есть. Для нагрузок, чувствительных к пропускной способности\n(большие наборы кандидатов с длинными документами), ответ получается намного больше ожидаемого — сопоставляйте результаты обратно\nпо `,_jsx(_components.code,{children:`index`}),` самостоятельно, вместо того чтобы полагаться на этот флаг.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Неверное имя модели возвращает 503, а не 404.`}),` Сообщение выглядит так:\n`,_jsx(_components.code,{children:`Current group default has no available channels for model xxx`}),`. Имя `,_jsx(_components.strong,{children:`чувствительно к регистру`}),` —\n`,_jsx(_components.code,{children:`BGE-Reranker-v2-M3`}),` считается несуществующей моделью. Если при интеграции вы получаете 503,\nпроверьте написание, прежде чем предполагать сбой канала.`]})}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Внешняя квота — самое жесткое ограничение этой модели: планируйте свои tokenы до интеграции.`})}),_jsxs(_components.p,{children:[`Внешний сервис (Huawei Cloud MaaS) разрешает для этой модели `,_jsx(_components.strong,{children:`TPM 20,000 / RPM 120`}),`. У модели эмбеддингов BGE-M3\nна той же платформе — 1,200,000 TPM — `,_jsx(_components.strong,{children:`в 60 раз больше`}),`.`]}),_jsxs(_components.p,{children:[`Тестирование разделило два `,_jsx(_components.strong,{children:`независимых`}),` механизма:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Механизм`}),_jsx(_components.th,{children:`Измеренное поведение`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Около 4–5 параллельных занятых слотов`})}),_jsxs(_components.td,{children:[`10 параллельных запросов → 4 успешны; 20 параллельных запросов → 5 успешны (tokenы составляют лишь 3–4% от TPM); `,_jsx(_components.strong,{children:`20 последовательных запросов → 20/20 успешны`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Окно TPM 20,000 со скользящим обновлением`})}),_jsxs(_components.td,{children:[`Срабатывает даже при `,_jsx(_components.strong,{children:`нулевой параллельности`}),`: при последовательной отправке запросов по 1.3K tokenов 8-й возвращает 429 при накопленных 16,093 tokenах, 9 подряд завершаются ошибкой, затем окно сдвигается и система восстанавливается`]})]})]})]}),_jsxs(_components.p,{children:[`Запросы сверх лимита слотов `,_jsx(_components.strong,{children:`отклоняются сразу, а не ставятся в очередь`}),`, и обе ошибки возвращают\nодинаковое сообщение `,_jsx(_components.code,{children:`upstream load saturated`}),` — по ответу их нельзя различить, поэтому\nвам нужно закладывать это в расчет нагрузки.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Рекомендация`}),`: ограничьте параллельные запросы до 4, добавьте экспоненциальный backoff и рассчитайте пропускную способность\nпо таблице ниже.`]})]}),`\n`,_jsx(Heading,{level:`3`,id:`сколько-поисков-в-минуту`,children:`Сколько поисков в минуту`}),`\n`,_jsxs(_components.p,{children:[`Если использовать измеренное `,_jsx(_components.code,{children:`≈26.9 tokens/document`}),` при TPM 20,000:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Кандидатов на запрос`}),_jsx(_components.th,{children:`tokenов на вызов`}),_jsx(_components.th,{children:`Теоретический предел`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`50`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`673`}),_jsx(_components.td,{children:`~29 / мин`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`100`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1,325`}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`~15 / мин`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`200`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2,629`}),_jsx(_components.td,{children:`~7 / мин`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Это также объясняет, почему один запрос не может содержать слишком много кандидатов: 1000 кандидатов — это\n26,867 tokenов, то есть `,_jsx(_components.strong,{children:`один запрос потребляет 134% всего минутного бюджета`}),`, поэтому он гарантированно\nполучит 429. При 2000 кандидатов это уже 269%.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Расширение квоты уже в процессе.`}),` TPM 20,000 выше — это начальное выделение у внешнего сервиса, и\nAPIYI уже подал заявку на его увеличение. Если ваша нагрузка превышает то, что позволяет таблица,\n`,_jsx(_components.strong,{children:`свяжитесь со службой поддержки APIYI, чтобы пересмотреть квоту внешнего сервиса`}),`, вместо того чтобы\nуменьшать архитектуру под текущее значение.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`/v1/rerank`}),` — единственно допустимый путь.`]}),` Запрос `,_jsx(_components.code,{children:`/rerank`}),` или `,_jsx(_components.code,{children:`/v2/rerank`}),` (значение по умолчанию в Cohere v2 SDK)\nвозвращает `,_jsx(_components.strong,{children:`HTTP 200 с HTML главной страницы сайта`}),`, а не JSON 404 — клиенты видят лишь\nнепонятную ошибку разбора. Если интеграция сообщает о «неподдающемся разбору ответе», сначала проверьте `,_jsx(_components.code,{children:`/v1`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`часто-задаваемые-вопросы`,children:`Часто задаваемые вопросы`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Могу ли я использовать только векторный поиск или реранжирование?`,id:`mogu-li-ya-ispolzovat-tolko-vektorniy-poisk-ili-reranzhirovanie`,children:[_jsx(_components.p,{children:`Только векторный поиск: это работает, но точность Top-N заметно хуже (измеренный nDCG@3 падает с\n1.00 до 0.53).`}),_jsxs(_components.p,{children:[`Реранжирование само по себе: `,_jsx(_components.strong,{children:`нет.`}),` У него нет векторного вывода, и ему нужен набор кандидатов. Оценивать миллионы\nдокументов по одному ни практично, ни экономически оправданно.`]}),_jsx(_components.p,{children:`Стандартная схема двухэтапная: сначала отобрать 50–100 с помощью векторов/BM25 → затем\nреранжировать до 3–5 → передать\nLLM.`})]}),_jsxs(Accordion,{title:`Сколько кандидатов мне нужно отбирать?`,id:`skolko-kandidatov-mne-nuzhno-otbirat`,children:[_jsx(_components.p,{children:`Измеренная задержка примерно линейно зависит от числа кандидатов (короткие документы): 10 ≈ 2 с,\n100 ≈ 4 с, 500 ≈ 15 с, 1000 ≈ 33 с.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`50–100 — это оптимальный диапазон.`}),` Ниже 20 у реранжировщика остается не так много ошибок в порядке,\nкоторые нужно исправлять. Выше 200 задержка уже начинает мешать интерактивности, а хвост списка\nкандидатов все равно редко содержит ответ.`]}),_jsxs(_components.p,{children:[`Бюджет тоже важен: 100 кандидатов — это ~1,325 token, поэтому TPM 20,000 позволяет только ~15 поисков в\nминуту. Удвойте число кандидатов — и вы вдвое снизите пропускную способность: `,_jsx(_components.strong,{children:`число кандидатов — это\nне только решение по качеству, но и решение по емкости`}),`.`]})]}),_jsxs(Accordion,{title:`Могу ли я направить на него Cohere или Jina SDK?`,id:`mogu-li-ya-napravit-na-nego-cohere-ili-jina-sdk`,children:[_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`cohere`}),` SDK v2 не работает как есть`]}),`: он нацелен на `,_jsx(_components.code,{children:`/v2/rerank`}),`, который возвращает HTML\nглавной страницы вместо JSON, поэтому SDK выдает ошибку разбора.`]}),_jsxs(_components.p,{children:[`Названия параметров (`,_jsx(_components.code,{children:`query`}),` / `,_jsx(_components.code,{children:`documents`}),` / `,_jsx(_components.code,{children:`top_n`}),` / `,_jsx(_components.code,{children:`return_documents`}),`) действительно соответствуют Cohere Rerank\nv1, но `,_jsx(_components.code,{children:`documents`}),` `,_jsx(_components.strong,{children:`принимает только массив строк`}),` (`,_jsx(_components.code,{children:`[{\"text\": \"...\"}]`}),` возвращает 400), а\nв ответе нет полей `,_jsx(_components.code,{children:`id`}),` / `,_jsx(_components.code,{children:`meta`}),`. `,_jsx(_components.strong,{children:`Проще всего обернуть HTTP-вызов самостоятельно`}),` —\n`,_jsx(_components.a,{href:`/ru/api-capabilities/rerank/rag-best-practices`,children:`Практическая настройка RAG`}),` содержит готовые\nадаптеры для LangChain и LlamaIndex.`]}),_jsxs(_components.p,{children:[`Проверенные рабочие клиенты: обычный `,_jsx(_components.code,{children:`requests`}),` POST ✅ и запасной вариант через SDK `,_jsx(_components.code,{children:`openai`}),`\n`,_jsx(_components.code,{children:`client.post(\"/rerank\", ...)`}),` ✅.`]})]}),_jsxs(Accordion,{title:`Могу ли я кэшировать результаты?`,id:`mogu-li-ya-keshirovat-rezultaty`,children:[_jsxs(_components.p,{children:[`Да, и это очень стабильно. `,_jsx(_components.strong,{children:`Повторение идентичного запроса 10 раз дает побитово идентичный результат`}),` (нулевой\nдрейф). Дрейф порядка ~3.7e-4 появляется только когда вы `,_jsx(_components.strong,{children:`перемешиваете порядок кандидатов`}),` (дрожание\nбатчинга bf16), и порядок не меняется.`]}),_jsxs(_components.p,{children:[`Привязывайте кэш к `,_jsx(_components.code,{children:`normalised query + ordered hash of document contents`}),`. Поскольку порядок\nвносит этот небольшой дрейф, `,_jsxs(_components.strong,{children:[`не рассматривайте `,_jsx(_components.code,{children:`relevance_score`}),` как ключ идемпотентности.`]})]})]}),_jsx(Accordion,{title:`Что происходит после 8192 token?`,id:`chto-proiskhodit-posle-8192-token`,children:_jsxs(_components.p,{children:[`Вы получите 400 с `,_jsx(_components.code,{children:`This model's maximum context length is 8192 tokens`}),`. Он `,_jsx(_components.strong,{children:`не обрезает\nданные молча.`}),` Лимит применяется к каждой паре запрос-документ, а не к запросу целиком — один\nзапрос с 400 documents × 1000 characters (330K tokens total) возвращается нормально.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`связанная-документация`,children:`Связанная документация`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ru/api-capabilities/rerank/rerank-api`,children:`Песочница Rerank API`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ru/api-capabilities/rerank/rag-best-practices`,children:`Практическая настройка RAG`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/ru/api-capabilities/text-embedding`,children:`Текстовые embeddings`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/en/models`,children:`Тарификация моделей`})}),`\n`]})]})}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":"bge-reranker-v2-m3 Переранжирование текста","sidebarTitle":"Обзор","description":"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.","icon":"list-ordered","href":"/ru/api-capabilities/rerank/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Что это такое и когда это использовать","slug":"что-это-такое-и-когда-это-использовать","depth":2,"children":[{"title":"Сравнение на конкретном примере","slug":"сравнение-на-конкретном-примере","depth":3,"children":[]}]},{"title":"Информация о модели","slug":"информация-о-модели","depth":2,"children":[]},{"title":"Тарификация","slug":"тарификация","depth":2,"children":[]},{"title":"Минимальный вызов","slug":"минимальный-вызов","depth":2,"children":[]},{"title":"Параметры запроса","slug":"параметры-запроса","depth":2,"children":[]},{"title":"Матрица измеренных возможностей","slug":"матрица-измеренных-возможностей","depth":2,"children":[]},{"title":"Три вещи, которые вы должны знать","slug":"три-вещи-которые-вы-должны-знать","depth":2,"children":[]},{"title":"Известные проблемы","slug":"известные-проблемы","depth":2,"children":[{"title":"Сколько поисков в минуту","slug":"сколько-поисков-в-минуту","depth":3,"children":[]}]},{"title":"Часто задаваемые вопросы","slug":"часто-задаваемые-вопросы","depth":2,"children":[]},{"title":"Связанная документация","slug":"связанная-документация","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"apiyillc","siteName":"API易文档中心","title":"bge-reranker-v2-m3 Переранжирование текста - API易文档中心","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh":{"href":"/api-capabilities/rerank/overview","matchLevel":1},"en":{"href":"/en/api-capabilities/rerank/overview","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/api-capabilities/rerank/overview","matchLevel":1},"ja":{"href":"/ja/api-capabilities/rerank/overview","matchLevel":1},"ko":{"href":"/ko/api-capabilities/rerank/overview","matchLevel":1},"ru":{"href":"/ru/api-capabilities/rerank/overview","matchLevel":0}}},"lastModified":"2026-07-30T15:04:14.847Z","originalFileLocation":"ru/api-capabilities/rerank/overview.mdx","locale":"ru"},"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 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\">\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=\"bge-reranker-v2-m3 Переранжирование текста - API易文档中心\">\u003cmeta data-mint-head property=\"og:description\" content=\"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview\">\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=%D0%A0%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5\u0026amp;title=bge-reranker-v2-m3+%D0%9F%D0%B5%D1%80%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5+%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0\u0026amp;description=bge-reranker-v2-m3+%E2%80%94+%D1%8D%D1%82%D0%BE+%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE%D1%8F%D0%B7%D1%8B%D1%87%D0%BD%D0%B0%D1%8F+%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D1%8C+%D0%BF%D0%B5%D1%80%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F%2C+%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D0%B0%D1%8F+%D0%BE%D1%86%D0%B5%D0%BD%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5+%D0%BA%D0%B0%D0%BD%D0%B4%D0%B8%D0%B4%D0%B0%D1%82%D1%8B+%D0%BE%D1%82%D0%BD%D0%BE%D1%81%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE+%D0%B2%D0%B0%D1%88%D0%B5%D0%B3%D0%BE+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0+%D0%B8+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BF%D0%BE%D1%80%D1%8F%D0%B4%D0%BE%D1%87%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D0%B8%D1%85+%E2%80%94+%D1%81%D0%B0%D0%BC%D0%BE%D0%B5\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=38ea053b2a9021a942e766f5cb178557a48f28fe704457a1448a44ef6aec04f9\">\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=\"bge-reranker-v2-m3 Переранжирование текста - API易文档中心\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=%D0%A0%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5\u0026amp;title=bge-reranker-v2-m3+%D0%9F%D0%B5%D1%80%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5+%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0\u0026amp;description=bge-reranker-v2-m3+%E2%80%94+%D1%8D%D1%82%D0%BE+%D0%BC%D0%BD%D0%BE%D0%B3%D0%BE%D1%8F%D0%B7%D1%8B%D1%87%D0%BD%D0%B0%D1%8F+%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D1%8C+%D0%BF%D0%B5%D1%80%D0%B5%D1%80%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F%2C+%D0%BA%D0%BE%D1%82%D0%BE%D1%80%D0%B0%D1%8F+%D0%BE%D1%86%D0%B5%D0%BD%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%BD%D1%8B%D0%B5+%D0%BA%D0%B0%D0%BD%D0%B4%D0%B8%D0%B4%D0%B0%D1%82%D1%8B+%D0%BE%D1%82%D0%BD%D0%BE%D1%81%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE+%D0%B2%D0%B0%D1%88%D0%B5%D0%B3%D0%BE+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0+%D0%B8+%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D0%BF%D0%BE%D1%80%D1%8F%D0%B4%D0%BE%D1%87%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D0%B8%D1%85+%E2%80%94+%D1%81%D0%B0%D0%BC%D0%BE%D0%B5\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=38ea053b2a9021a942e766f5cb178557a48f28fe704457a1448a44ef6aec04f9\">\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/ru/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ru/api-capabilities/rerank/overview.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.apiyi.com/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apiyi.com/en/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.apiyi.com/zh-Hant/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apiyi.com/ja/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apiyi.com/ko/api-capabilities/rerank/overview\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apiyi.com/api-capabilities/rerank/overview\">\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/ru/api-capabilities/rerank/overview#webpage\",\"url\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview\",\"name\":\"bge-reranker-v2-m3 Переранжирование текста\",\"description\":\"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\",\"dateModified\":\"2026-07-30T15:04:14.847Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Поиск и безопасность\",\"item\":\"https://docs.apiyi.com/ru/api-capabilities/text-embedding\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"bge-reranker-v2-m3 Переранжирование текста\",\"item\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview#article\",\"headline\":\"bge-reranker-v2-m3 Переранжирование текста\",\"name\":\"bge-reranker-v2-m3 Переранжирование текста\",\"description\":\"bge-reranker-v2-m3 — это многоязычная модель переранжирования, которая оценивает полученные кандидаты относительно вашего запроса и переупорядочивает их — самое дешевое осмысленное улучшение качества поиска для RAG. Доступно в APIYI по адресу /v1/rerank, $0.01 за 1M tokens.\",\"url\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ru/api-capabilities/rerank/overview#webpage\"},\"dateModified\":\"2026-07-30T15:04:14.847Z\",\"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/overview"}]},{"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/overview"}]},{"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/overview"}]},{"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/overview"}]},{"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"}},"pages":[{"title":"ko","href":"/ko/api-capabilities/rerank/overview"}]},{"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"}},"tabs":[{"tab":"Главная","icon":"house","groups":[{"group":"Основы","pages":[{"title":"APIYI - Хаб API моделей ИИ","sidebarTitle":"Введение","icon":"house","href":"/ru"},{"title":"Быстрый старт","icon":"rocket","href":"/ru/getting-started"},{"group":"Набор инструментов разработчика ИИ","icon":"terminal","pages":[{"title":"Набор инструментов для разработчиков ИИ","sidebarTitle":"Набор инструментов для разработчиков ИИ","icon":"bot","href":"/ru/developer-kit"},{"title":"Почему терминал сообщает, что команда apiyi не найдена?","icon":"terminal","href":"/ru/faq/apiyi-cli-command-not-found"}]},{"group":"Руководство по API","icon":"book","pages":[{"title":"Руководство по API","sidebarTitle":"Обзор руководства","icon":"book","href":"/ru/api-manual"},{"title":"Захват деталей ошибок API","sidebarTitle":"Захват ошибок","icon":"clipboard-list","href":"/ru/api-manual/error-reporting"},{"group":"Подключение API: частые вопросы","icon":"circle-question-mark","expanded":false,"pages":[{"title":"Поддерживает ли APIYI API файлов?","icon":"file-up","href":"/ru/faq/files-api-not-supported"},{"title":"Как настроить Base URL? Различия между /v1, корневым доменом и /v1beta","icon":"link","href":"/ru/faq/base-url-config"},{"title":"Как устранить ошибки API модели?","icon":"alert-triangle","href":"/ru/faq/model-error-troubleshooting"},{"title":"Каковы лимиты параллельных запросов API?","icon":"gauge","href":"/ru/faq/api-concurrency"}]}]},{"title":"Тарифы","icon":"badge-dollar-sign","href":"/ru/pricing"}]},{"group":"Базовый API","icon":"box","pages":[{"group":"Информация о моделях","icon":"cpu","pages":[{"title":"Популярные модели","icon":"database","href":"/ru/api-capabilities/model-info"},{"group":"Модели: частые вопросы","icon":"circle-question-mark","expanded":false,"pages":[{"title":"Как выбрать подходящую модель ИИ?","icon":"compass","href":"/ru/faq/model-selection-guide"},{"title":"Почему официальные веб-приложения и API дают разные результаты?","icon":"layers","href":"/ru/faq/webapp-vs-api-difference"},{"title":"Почему модели ИИ не знают свою собственную версию?","icon":"circle-question-mark","href":"/ru/faq/model-version-identity"}]}]},{"title":"Модели генерации изображений и видео","icon":"palette","href":"/ru/api-capabilities/image-video-models"},{"group":"Вызовы OpenAI API","icon":"sparkles","pages":[{"title":"Руководство по нативному OpenAI Responses API","sidebarTitle":"Нативные вызовы","icon":"zap","href":"/ru/api-capabilities/openai/native"},{"title":"Режим совместимости OpenAI Chat Completions","sidebarTitle":"Совместимый режим","icon":"plug","href":"/ru/api-capabilities/openai/compatible"},{"title":"Выбор эндпоинта: миграция GPT-5.4+ на Responses","sidebarTitle":"Эндпоинт и миграция","icon":"route","href":"/ru/api-capabilities/openai/responses-migration"},{"title":"Режим совместимости OpenAI: обработка ответов","sidebarTitle":"Обработка ответов","icon":"braces","href":"/ru/api-capabilities/openai/response-handling"},{"title":"OpenAI Compatible Mode: Вывод модели рассуждений","sidebarTitle":"Вывод модели рассуждений","icon":"brain","href":"/ru/api-capabilities/openai/reasoning-models"},{"title":"Руководство по тарификации Prompt Caching OpenAI","sidebarTitle":"Тарификация кэша","icon":"database","href":"/ru/api-capabilities/openai/prompt-caching"},{"title":"Руководство по Function Calling OpenAI","sidebarTitle":"Function Calling","icon":"wrench","href":"/ru/api-capabilities/openai/function-calling"},{"title":"Руководство по веб-поиску в OpenAI API","sidebarTitle":"Веб-поиск","icon":"globe","href":"/ru/api-capabilities/openai/web-search"},{"group":"OpenAI: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Поддерживает ли APIYI быстрый / сверхбыстрый режим OpenAI?","icon":"gauge","href":"/ru/faq/openai-service-tier-fast-mode"},{"title":"Чем отличаются запросы с потоковой передачей и без неё при фильтрации контента?","sidebarTitle":"Потоковая передача и фильтрация контента","icon":"shield-half","href":"/ru/faq/streaming-content-filter"},{"title":"Как выглядит отказ модели OpenAI?","icon":"message-square-x","href":"/ru/faq/openai-content-safety-refusal"}]}]},{"group":"Официальный Claude","icon":"sparkles","pages":[{"title":"Основы вызовов API Claude","sidebarTitle":"Основы API Claude","icon":"sparkles","href":"/ru/api-capabilities/claude"},{"title":"Нативный формат Claude: потоковая передача и ответы без потоковой передачи","sidebarTitle":"Потоковая передача и ответы","icon":"braces","href":"/ru/api-capabilities/claude-response-handling"},{"title":"Руководство Claude по кэшированию промптов","sidebarTitle":"Кэширование промптов","icon":"database","href":"/ru/api-capabilities/claude-prompt-caching"},{"title":"Руководство по Effort и Thinking для Claude","sidebarTitle":"Effort и Thinking","icon":"gauge","href":"/ru/api-capabilities/claude-effort-thinking"},{"title":"Руководство по веб-поиску Claude API","sidebarTitle":"Веб-поиск Claude","icon":"globe","href":"/ru/api-capabilities/claude-web-search"},{"group":"Claude: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Почему Claude утверждает, что он Qwen или DeepSeek?","icon":"venetian-mask","href":"/ru/faq/claude-identity-confusion"},{"title":"Как исправить ошибку недействительной подписи thinking в Claude?","icon":"file-signature","href":"/ru/faq/claude-thinking-signature-invalid"},{"title":"Почему при отказе Claude возвращается пустое содержимое?","icon":"message-square-x","href":"/ru/faq/claude-content-safety-refusal"}]}]},{"group":"Нативные вызовы Gemini","icon":"sparkles","pages":[{"title":"Руководство по нативному формату Gemini","sidebarTitle":"Нативные вызовы","icon":"zap","href":"/ru/api-capabilities/gemini/native"},{"title":"Interactions API против generateContent","sidebarTitle":"Сравнение Interactions API","icon":"git-compare","href":"/ru/api-capabilities/gemini/interactions-api"},{"title":"Нативный формат Gemini: потоковые и непотоковые ответы","sidebarTitle":"Потоковая передача и ответы","icon":"braces","href":"/ru/api-capabilities/gemini/response-handling"},{"title":"Мультимодальный ввод и выполнение кода в Gemini","sidebarTitle":"Мультимодальность и выполнение кода","icon":"images","href":"/ru/api-capabilities/gemini/multimodal"},{"title":"Руководство по тарификации неявного кэширования Gemini","sidebarTitle":"Тарификация кэша","icon":"database","href":"/ru/api-capabilities/gemini/prompt-caching"},{"title":"Руководство по вызову функций Gemini","sidebarTitle":"Вызов функций","icon":"wrench","href":"/ru/api-capabilities/gemini/function-calling"},{"title":"Руководство по веб-поиску для Gemini API","sidebarTitle":"Веб-поиск","icon":"globe","href":"/ru/api-capabilities/gemini/web-search"},{"title":"Как исправить ошибки 400 (Thought Signature) в Gemini при вызовах инструментов?","icon":"file-signature","href":"/ru/faq/gemini-thought-signature-missing"}]},{"group":"Вызовы API Grok","icon":"sparkles","pages":[{"title":"Руководство по серии моделей Grok","sidebarTitle":"Обзор Grok","icon":"rocket","href":"/ru/api-capabilities/grok/overview"},{"title":"Руководство по Grok Chat и рассуждению","sidebarTitle":"Чат и рассуждение","icon":"message-square","href":"/ru/api-capabilities/grok/chat"},{"title":"Руководство по Web Search и X Search в Grok","sidebarTitle":"Web и X Search","icon":"globe","href":"/ru/api-capabilities/grok/web-search"},{"title":"Выполнение кода и руководство по Remote MCP для Grok","sidebarTitle":"Выполнение кода и MCP","icon":"terminal","href":"/ru/api-capabilities/grok/code-execution-mcp"},{"title":"Руководство по модели Grok Multi-Agent","sidebarTitle":"Мультиагентная модель","icon":"users","href":"/ru/api-capabilities/grok/multi-agent"},{"title":"Руководство по тарификации кэширования Grok","sidebarTitle":"Тарификация кэша","icon":"database","href":"/ru/api-capabilities/grok/prompt-caching"}]},{"group":"Лучшие практики текстового API","icon":"book-check","pages":[{"title":"Практики работы с длинными ответами","sidebarTitle":"Длинные ответы","icon":"book-check","href":"/ru/api-capabilities/long-form-output-practices"},{"title":"Руководство по многотуровому диалогу","sidebarTitle":"Многотуровый диалог","icon":"messages-square","href":"/ru/api-capabilities/multi-turn-conversation"},{"group":"Текст: частые вопросы","icon":"circle-question-mark","expanded":false,"pages":[{"title":"В чём разница между вызовами с потоковой передачей и без потоковой передачи?","sidebarTitle":"Потоковая передача vs без потоковой передачи","icon":"audio-lines","href":"/ru/faq/streaming-vs-non-streaming"},{"title":"Что такое max_tokens? Что произойдет, если не задавать?","icon":"sliders-horizontal","href":"/ru/faq/max-tokens"},{"title":"Есть ли у API память, как у ChatGPT?","icon":"brain","href":"/ru/faq/api-memory"}]}]},{"title":"API запроса баланса","icon":"wallet","href":"/ru/api-capabilities/balance-query"},{"title":"API запроса журналов","icon":"file-text","href":"/ru/api-capabilities/log-query"},{"title":"Управление token API","icon":"key","href":"/ru/api-capabilities/token-management"},{"title":"Устаревшие модели","icon":"triangle-alert","href":"/ru/api-capabilities/deprecated-models"}]},{"group":"Image API (официальный)","icon":"image","pages":[{"group":"Основы Image API","icon":"book-check","pages":[{"title":"Основы API изображений и лучшие практики","sidebarTitle":"Обязательно к прочтению и лучшие практики","icon":"book-check","href":"/ru/api-capabilities/image-api-best-practices"},{"title":"Устранение обрывов соединения с API изображений","sidebarTitle":"Обрывы соединения","icon":"unplug","href":"/ru/api-capabilities/image-connection-drops"},{"title":"Запросы на изображение, которые зависают после получения данных","sidebarTitle":"Запросы, зависающие в конце","icon":"hourglass","href":"/ru/api-capabilities/image-tail-stall"},{"title":"Сжатие изображений и выходное разрешение","sidebarTitle":"Сжатие и разрешение","icon":"scaling","href":"/ru/api-capabilities/image-compression-resolution"},{"title":"Как получать удовлетворительные изображения","sidebarTitle":"Получение удовлетворительных изображений","icon":"target","href":"/ru/api-capabilities/image-generation-success-tips"},{"title":"Устранение отклонений по соображениям безопасности: найдите триггерное слово методом абляции","sidebarTitle":"Отклонения по соображениям безопасности","icon":"shield-alert","href":"/ru/api-capabilities/image-safety-troubleshooting"},{"title":"Длинные prompt и двухэтапная генерация: откуда берется лимит в 32K","sidebarTitle":"Длинные prompt","icon":"text-quote","href":"/ru/api-capabilities/image-long-prompt"},{"title":"Продвинутая генерация изображений: рабочий процесс и реализм","sidebarTitle":"Продвинутый рабочий процесс","icon":"workflow","href":"/ru/api-capabilities/image-advanced-workflow"},{"title":"Навык Image Prompt Doctor","sidebarTitle":"Навык Prompt Doctor","icon":"stethoscope","href":"/ru/api-capabilities/image-prompt-doctor"},{"group":"Изображения: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Есть ли conversational API, который выводит и текст, и сгенерированные изображения?","sidebarTitle":"Текст + изображение в одном API","icon":"images","href":"/ru/faq/text-and-image-in-one-api"},{"title":"Запрос на генерацию изображения зависает без результата, но в журнале указана ошибка записи?","icon":"hourglass","href":"/ru/faq/image-direct-large-response-stall"},{"title":"Запросы на генерацию изображений обрываются примерно через 90 секунд при работе через прокси?","icon":"unplug","href":"/ru/faq/proxy-idle-timeout-disconnect"},{"title":"Почему сгенерированное изображение сильно отличается от референса?","icon":"image","href":"/ru/faq/image-result-differs-from-reference"},{"title":"Как исправить ошибку несоответствия содержимого изображения MIME-типу?","icon":"image","href":"/ru/faq/image-mime-type-mismatch-with-query"},{"title":"Есть ли асинхронный API для генерации изображений? Можно ли запрашивать результаты по ID задачи?","icon":"image","href":"/ru/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":"/ru/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":"/ru/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":"/ru/api-capabilities/gpt-image-2/image-edit"},{"title":"GPT-Image-2.5 / 2 Серия навыка агента","icon":"blocks","href":"/ru/api-capabilities/gpt-image-2/skills"},{"title":"Руководство по масковому inpainting","sidebarTitle":"Масковый inpainting","icon":"brush","href":"/ru/api-capabilities/gpt-image-2/mask-editing"},{"title":"Устаревшие версии GPT-Image","sidebarTitle":"Устаревшие версии GPT-Image","icon":"rotate-ccw-clock","href":"/ru/api-capabilities/gpt-image-2/historical-versions"},{"group":"GPT-Image: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Как генерировать изображения с прозрачным фоном (PNG без фона)?","icon":"layers","href":"/ru/faq/image-transparent-background"},{"title":"Почему у GPT Image так много output tokens?","icon":"calculator","href":"/ru/faq/gpt-image-output-token-calculation"},{"title":"Интеграция Codex для GPT-Image завершается ошибкой из-за неверного API-ключа","sidebarTitle":"Ключ изображения отклонён OpenAI","icon":"key-round","href":"/ru/faq/gpt-image-incorrect-api-key-openai"}]}]},{"title":"GPT-image-2.5 / 2: официальные модели против reverse-версий","sidebarTitle":"GPT-image-2.5 / 2: официальные против reverse-версий","icon":"scale","href":"/ru/api-capabilities/gpt-image-2/vs-gpt-image-2-all"},{"group":"Генерация изображений GPT-Image-2.5-All","icon":"sparkles","pages":[{"title":"GPT-Image-2.5-All: генерация/редактирование изображений","sidebarTitle":"Обзор GPT-Image-2.5-All","icon":"sparkles","href":"/ru/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":"/ru/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":"/ru/api-capabilities/gpt-image-2-all/image-edit"},{"title":"Навык агента GPT-Image-2.5-All","icon":"blocks","href":"/ru/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":"/ru/api-capabilities/gpt-image-2-vip/overview"},{"title":"Справочник API Text-to-Image","openapi":"api-reference/gpt-image-2-vip-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ru/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":"/ru/api-capabilities/gpt-image-2-vip/image-edit"},{"title":"Навык агента GPT-Image-2.5-VIP","icon":"blocks","href":"/ru/api-capabilities/gpt-image-2-vip/skills"}]},{"title":"Тарифы серии Nano Banana","icon":"tag","href":"/ru/api-capabilities/nano-banana-pricing"},{"group":"Лучшие практики NanoBanana","icon":"lightbulb","pages":[{"title":"Руководство разработчика по серии Nano Banana","icon":"compass","href":"/ru/api-capabilities/nano-banana-dev-guide"},{"title":"Пояснение полей Usage и вывода","sidebarTitle":"Пояснение полей Usage и вывода","icon":"receipt-text","href":"/ru/api-capabilities/nano-banana-usage-metadata"},{"title":"Руководство по обработке ошибок API генерации изображений Gemini","icon":"triangle-alert","href":"/ru/api-capabilities/gemini-image-error-handling"},{"title":"Руководство по тестированию слияния нескольких изображений","sidebarTitle":"Тестирование слияния нескольких изображений","icon":"layers","href":"/ru/api-capabilities/multi-image-fusion-testing"},{"title":"План возмещения кредитов за неудачную генерацию Nano Banana Pro","icon":"shield-check","href":"/ru/api-capabilities/nano-banana-pro-guarantee"},{"title":"Группа Nano Banana OSS","icon":"link","href":"/ru/api-capabilities/nano-banana-oss-group"},{"group":"NB: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Запускаются ли модели Google в AI Studio или Vertex?","icon":"split","href":"/ru/faq/google-upstream-aistudio-vertex"},{"title":"При редактировании изображений возвращается Unable to Process Input Image?","icon":"image-off","href":"/ru/faq/gemini-empty-inlinedata"},{"title":"Почему Gemini Image возвращает IMAGE_OTHER?","sidebarTitle":"IMAGE_OTHER","icon":"image-minus","href":"/ru/faq/gemini-image-other"},{"title":"Почему Gemini Image возвращает blockReason: OTHER?","sidebarTitle":"blockReason: OTHER","icon":"shield-alert","href":"/ru/faq/gemini-image-input-blocked"},{"title":"Основные причины сбоев генерации изображений Nano Banana","icon":"image-off","href":"/ru/faq/nano-banana-image-failure"},{"title":"Почему API Gemini для генерации изображений возвращает NO_IMAGE?","icon":"image-off","href":"/ru/faq/gemini-no-image"},{"title":"Почему мое изображение становится красноватым после редактирования в Nano Banana Pro?","icon":"image","href":"/ru/faq/banana-pro-edit-red-cast"},{"title":"Как исправить искажения при смене одежды с Nano Banana Pro?","icon":"shirt","href":"/ru/faq/nano-banana-pro-print-distortion"},{"title":"Почему на изображении с белым фоном появляются чёрные пятна, грязные разводы или размытые цветные блоки?","icon":"triangle-alert","href":"/ru/faq/white-background-image-artifacts"}]}]},{"group":"Генерация изображений Nano Banana 2.1","icon":"banana","pages":[{"title":"Nano Banana 2.1: генерация и редактирование изображений","icon":"banana","href":"/ru/api-capabilities/gemini-nano-banana-2.1/overview"},{"title":"Справочник по API Text-to-Image","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":"/ru/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":"/ru/api-capabilities/gemini-nano-banana-2.1/image-edit"},{"title":"Agent Skill для Nano Banana 2.1","icon":"blocks","href":"/ru/api-capabilities/gemini-nano-banana-2.1/skills"}]},{"group":"Генерация изображений Nano Banana Pro","icon":"banana","pages":[{"title":"Генерация изображений Nano Banana Pro","icon":"banana","href":"/ru/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":"/ru/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":"/ru/api-capabilities/nano-banana-image/image-edit"},{"title":"Навык агента Nano Banana Pro","icon":"blocks","href":"/ru/api-capabilities/nano-banana-image/skills"}]},{"group":"Генерация изображений Nano Banana 2","icon":"banana","pages":[{"title":"Nano Banana 2: генерация и редактирование изображений","icon":"banana","href":"/ru/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":"/ru/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":"/ru/api-capabilities/nano-banana-2-image/image-edit"},{"title":"Навык агента Nano Banana 2","icon":"blocks","href":"/ru/api-capabilities/nano-banana-2-image/skills"}]},{"group":"Генерация изображений Nano Banana Lite","icon":"banana","pages":[{"title":"Nano Banana Lite Генерация/редактирование изображений","icon":"banana","href":"/ru/api-capabilities/nano-banana-lite-image/overview"},{"title":"Справочник API Text-to-Image","openapi":"api-reference/nano-banana-lite-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"wand-sparkles","href":"/ru/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":"/ru/api-capabilities/nano-banana-lite-image/image-edit"},{"title":"Навык Agent Skill для Nano Banana Lite","icon":"blocks","href":"/ru/api-capabilities/nano-banana-lite-image/skills"}]},{"group":"Генерация и редактирование изображений FLUX","icon":"sparkles","pages":[{"title":"Генерация и редактирование изображений FLUX","sidebarTitle":"Обзор FLUX","icon":"sparkles","href":"/ru/api-capabilities/flux/overview"},{"title":"Справочник API для преобразования текста в изображение","openapi":"api-reference/flux-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ru/api-capabilities/flux/text-to-image"},{"title":"Справочник API по редактированию изображений","openapi":"api-reference/flux-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ru/api-capabilities/flux/image-edit"},{"title":"Исторические версии FLUX","sidebarTitle":"Исторические версии","icon":"rotate-ccw-clock","href":"/ru/api-capabilities/flux/historical-versions"}]},{"group":"Серия Seedream 5.0","icon":"sparkles","pages":[{"title":"Генерация и редактирование изображений Seedream","sidebarTitle":"Обзор Seedream","icon":"sparkles","href":"/ru/api-capabilities/seedream-image/overview"},{"title":"Справочник API Text-to-Image","openapi":"api-reference/seedream-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ru/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":"/ru/api-capabilities/seedream-image/image-edit"},{"title":"Предыдущие версии Seedream","sidebarTitle":"Предыдущие версии","icon":"rotate-ccw-clock","href":"/ru/api-capabilities/seedream-image/historical-versions"}]},{"group":"Grok Imagine: официальная генерация изображений","icon":"sparkles","pages":[{"title":"Официальная генерация изображений Grok Imagine","sidebarTitle":"Официальный обзор Grok Imagine","icon":"sparkles","href":"/ru/api-capabilities/grok-imagine-image-official/overview"},{"title":"Справочник по официальному API генерации изображений по тексту Grok Imagine","sidebarTitle":"Генерация изображений по тексту","openapi":"api-reference/grok-imagine-image-official-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ru/api-capabilities/grok-imagine-image-official/text-to-image"}]},{"group":"Grok Imagine (reverse): генерация и редактирование изображений","icon":"sparkles","pages":[{"title":"Grok Imagine Reverse: генерация и редактирование изображений","sidebarTitle":"Обзор Grok Imagine Reverse","icon":"sparkles","href":"/ru/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":"/ru/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":"/ru/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":"/ru/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":"/ru/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":"/ru/api-capabilities/mai-image/image-edit"}]},{"title":"Практика интеграции Image API: создайте собственную асинхронную очередь","sidebarTitle":"Самостоятельно размещенная асинхронная очередь","icon":"list-checks","href":"/ru/api-capabilities/image-async-queue"}]},{"group":"Video API (официальный)","icon":"video","pages":[{"group":"Seedance 2.0 / 2.5 (Volcano Engine)","icon":"film","pages":[{"title":"Seedance 2.0 / 2.5 Генерация видео","sidebarTitle":"Обзор Seedance 2.0 / 2.5","icon":"film","href":"/ru/api-capabilities/seedance2/overview"},{"title":"Справочник API для генерации видео Seedance 2.0 / 2.5","sidebarTitle":"Генерация видео","openapi":"api-reference/seedance2-video-openapi-en.yaml POST /seedance/api/v3/contents/generations/tasks","icon":"video","href":"/ru/api-capabilities/seedance2/video-generation"},{"title":"Навык агента для генерации видео Seedance 2.0","icon":"blocks","href":"/ru/api-capabilities/seedance2/skills"},{"title":"Библиотека ассетов Seedance 2.0 (видео с сохранением персонажа)","sidebarTitle":"Библиотека ассетов","icon":"images","href":"/ru/api-capabilities/seedance2/asset-library"},{"title":"Генерация видео с привязкой к asset в коде","sidebarTitle":"Руководство по ссылкам на asset","icon":"clapperboard","href":"/ru/api-capabilities/seedance2/asset-reference"},{"title":"Сначала ресурсы: более быстрая и надёжная передача изображений и видео","sidebarTitle":"Рабочий процесс «Сначала ресурсы»","icon":"gauge","href":"/ru/api-capabilities/seedance2/asset-first-workflow"},{"group":"SD: частые вопросы","icon":"circle-question-mark","pages":[{"title":"Seedance сообщает, что первый/последний кадр нельзя смешивать с референсными медиа","sidebarTitle":"Смешивание первого кадра с референсом","icon":"layers","href":"/ru/faq/seedance-first-frame-mixed-with-reference"},{"title":"Seedance сообщает об ошибке invalid image format, но ссылка открывается в браузере","sidebarTitle":"Ссылка на изображение открывается, но не работает","icon":"link","href":"/ru/faq/seedance-image-url-invalid-format"},{"title":"Seedance 2.5: референс-видео и редактирование видео","icon":"split","href":"/ru/faq/seedance2-reference-vs-edit"},{"title":"Можно ли отменить задачу Seedance после отправки?","icon":"video","href":"/ru/faq/seedance-video-task-cancel"},{"title":"Как узнать фактическую стоимость видео Seedance по task_id?","icon":"receipt","href":"/ru/faq/seedance-task-cost-lookup"},{"title":"Загружает ли Seedance 2.0 автоматически референсы лиц в библиотеку ассетов? Срабатывает ли при этом фильтр deepfake?","icon":"banana","href":"/ru/faq/seedance2-asset-face-reference"},{"title":"Почему Seedance 2.0 / 2.5 блокирует ассеты с лицами?","icon":"scan-face","href":"/ru/faq/seedance2-face-asset-whitelist"}]}]},{"group":"Генерация видео Wan3.0 (Alibaba Cloud)","icon":"video","pages":[{"title":"Генерация видео Wan3.0 (Alibaba Tongyi Wanxiang)","sidebarTitle":"Обзор","icon":"video","href":"/ru/api-capabilities/wan3/overview"},{"title":"Справочник API генерации видео Wan3.0","sidebarTitle":"Генерация видео","openapi":"api-reference/wan3-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ru/api-capabilities/wan3/video-generation"}]},{"group":"Генерация видео Wan2.7 (Alibaba Cloud)","icon":"videotape","pages":[{"title":"Генерация видео Wan (Alibaba Cloud Tongyi Wanxiang)","sidebarTitle":"Обзор Wan","icon":"video","href":"/ru/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":"/ru/api-capabilities/wan/text-to-video"},{"title":"Wan2.7 Image-to-Video API Reference","sidebarTitle":"Изображение-в-видео","openapi":"api-reference/wan-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ru/api-capabilities/wan/image-to-video"},{"title":"Справочник API Wan2.7 для генерации видео по референсу","sidebarTitle":"Генерация видео по референсу","openapi":"api-reference/wan-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ru/api-capabilities/wan/reference-to-video"},{"title":"Справочник API для редактирования видео Wan2.7","sidebarTitle":"Редактирование видео","openapi":"api-reference/wan-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ru/api-capabilities/wan/video-edit"},{"title":"Навык Agent Skill для видео Wan2.7 и HappyHorse","icon":"blocks","href":"/ru/api-capabilities/wan/skills"},{"title":"Исторические версии Wan (Wan2.6)","sidebarTitle":"Исторические версии","icon":"rotate-ccw-clock","href":"/ru/api-capabilities/wan/historical-versions"}]},{"group":"Генерация видео HappyHorse (Alibaba Cloud)","icon":"monitor-play","pages":[{"title":"Генерация видео HappyHorse (Alibaba Cloud)","sidebarTitle":"Обзор HappyHorse","icon":"monitor-play","href":"/ru/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":"/ru/api-capabilities/happyhorse/text-to-video"},{"title":"Справочник API HappyHorse по преобразованию изображения в видео","sidebarTitle":"Изображение в видео","openapi":"api-reference/happyhorse-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ru/api-capabilities/happyhorse/image-to-video"},{"title":"Справочник API Reference-to-Video HappyHorse","sidebarTitle":"Reference-to-Video","openapi":"api-reference/happyhorse-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ru/api-capabilities/happyhorse/reference-to-video"},{"title":"Справочник API для редактирования видео HappyHorse","sidebarTitle":"Редактирование видео","openapi":"api-reference/happyhorse-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ru/api-capabilities/happyhorse/video-edit"},{"title":"Навык видео-агента HappyHorse","icon":"blocks","href":"/ru/api-capabilities/happyhorse/skills"}]},{"group":"VEO 3.1 (Google)","icon":"clapperboard","pages":[{"title":"VEO 3.1 Официальная генерация видео","sidebarTitle":"VEO 3.1 Официальный обзор","icon":"video","href":"/ru/api-capabilities/veo-3-1-official/overview"},{"title":"Официальный API VEO 3.1 для преобразования текста в видео","sidebarTitle":"Текст в видео","openapi":"api-reference/veo-3-1-official-text-to-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ru/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":"/ru/api-capabilities/veo-3-1-official/image-to-video"},{"title":"Сравнение VEO 3.1 Official и Reverse Channel","sidebarTitle":"Official vs Reverse","icon":"scale","href":"/ru/api-capabilities/veo-3-1-official/vs-veo-reverse"}]},{"group":"Grok Imagine: генерация видео (xAI)","icon":"camera","pages":[{"title":"Генерация видео Grok Imagine","sidebarTitle":"Обзор Grok Imagine Video","icon":"video","href":"/ru/api-capabilities/grok-imagine-video/overview"},{"title":"Справочник по API генерации видео Grok Imagine","sidebarTitle":"Генерация видео","openapi":"api-reference/grok-imagine-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ru/api-capabilities/grok-imagine-video/video-generation"}]},{"group":"MiniMax H3: генерация видео (собственное развёртывание)","icon":"film","pages":[{"title":"Генерация видео MiniMax-H3","sidebarTitle":"Обзор MiniMax-H3","icon":"video","href":"/ru/api-capabilities/minimax-h3/overview"},{"title":"Справочник API по генерации видео MiniMax-H3","sidebarTitle":"Генерация видео","openapi":"api-reference/minimax-h3-video-openapi-en.yaml POST /hailuo/v2/video_generation","icon":"video","href":"/ru/api-capabilities/minimax-h3/video-generation"}]},{"group":"Oxygen: генерация видео (AZ8)","icon":"clapperboard","pages":[{"title":"Генерация видео Oxygen","sidebarTitle":"Обзор Oxygen","icon":"video","href":"/ru/api-capabilities/oxygen/overview"},{"title":"Справочник по API генерации видео Oxygen","sidebarTitle":"Генерация видео","openapi":"api-reference/oxygen-video-openapi-en.yaml POST /videos","icon":"video","href":"/ru/api-capabilities/oxygen/video-generation"}]}]},{"group":"API мультимодального понимания","icon":"eye","pages":[{"title":"API зрительного восприятия (распознавание изображений)","icon":"eye","href":"/ru/api-capabilities/vision-understanding"},{"title":"API анализа видео","icon":"video","href":"/ru/api-capabilities/video-understanding"},{"title":"Запросы на анализ изображений завершаются по таймауту — изображение слишком большое?","icon":"image","href":"/ru/faq/vision-image-too-large"}]},{"group":"Генерация текста","icon":"file-text","pages":[{"title":"Генерация текста (Chat Completions)","icon":"message-square","href":"/ru/api-capabilities/text-generation"},{"group":"Gemini 4 Argon","icon":"sparkles","pages":[{"title":"Генерация текста Gemini 4 Argon","sidebarTitle":"Обзор Gemini 4 Argon","icon":"sparkles","href":"/ru/api-capabilities/gemini-4-argon/overview"}]},{"group":"GPT-6 Astra","icon":"sparkles","pages":[{"title":"Генерация текста GPT-6 Astra","sidebarTitle":"Обзор GPT-6 Astra","icon":"sparkles","href":"/ru/api-capabilities/gpt-6-astra/overview"}]},{"group":"DeepSeek V4 Flash Vision","icon":"eye","pages":[{"title":"DeepSeek V4 Flash Vision","sidebarTitle":"Обзор","icon":"eye","href":"/ru/api-capabilities/deepseek-v4-flash-vision/overview"},{"title":"Справочник Chat API для DeepSeek V4 Flash Vision","sidebarTitle":"Песочница чата","openapi":"api-reference/deepseek-v4-flash-vision-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ru/api-capabilities/deepseek-v4-flash-vision/chat-completions"},{"title":"DeepSeek V4 Flash Vision Messages API Reference","sidebarTitle":"Песочница сообщений","openapi":"api-reference/deepseek-v4-flash-vision-messages-openapi-en.yaml POST /v1/messages","icon":"terminal","href":"/ru/api-capabilities/deepseek-v4-flash-vision/messages"}]},{"group":"DeepSeek V4 Flash","icon":"zap","pages":[{"title":"DeepSeek V4 Flash Генерация текста","sidebarTitle":"Обзор","icon":"zap","href":"/ru/api-capabilities/deepseek-v4-flash/overview"},{"title":"Справочник по Chat API DeepSeek V4 Flash","sidebarTitle":"Песочница чата","openapi":"api-reference/deepseek-v4-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ru/api-capabilities/deepseek-v4-flash/chat-completions"},{"title":"DeepSeek V4 Flash Responses — справочник API","sidebarTitle":"Песочница Responses","openapi":"api-reference/deepseek-v4-flash-responses-openapi-en.yaml POST /v1/responses","icon":"git-fork","href":"/ru/api-capabilities/deepseek-v4-flash/responses"}]},{"group":"DeepSeek Search \u0026 Fetch","icon":"search","pages":[{"title":"API DeepSeek Web Search и Fetch","sidebarTitle":"Обзор","icon":"search","href":"/ru/api-capabilities/deepseek-search-fetch/overview"},{"title":"Справочник по DeepSeek Web Search API","sidebarTitle":"Песочница поиска","openapi":"api-reference/deepseek-search-openapi-en.yaml POST /v1/tools/search","icon":"terminal","href":"/ru/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":"/ru/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":"/ru/api-capabilities/dola-seed-2-1-turbo/overview"},{"title":"Справочник API чата Seed 2.1 Turbo","sidebarTitle":"Песочница чата","openapi":"api-reference/dola-seed-2-1-turbo-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ru/api-capabilities/dola-seed-2-1-turbo/chat-completions"},{"title":"Справочник по Responses API для Seed 2.1 Turbo","sidebarTitle":"Песочница Responses","openapi":"api-reference/dola-seed-2-1-turbo-responses-openapi-en.yaml POST /v1/responses","icon":"messages-square","href":"/ru/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":"/ru/api-capabilities/gemini-3-8-flash/overview"},{"title":"Генерация текста с Gemini 3.6 Flash","sidebarTitle":"Обзор Gemini 3.6 Flash","icon":"sparkles","href":"/ru/api-capabilities/gemini-3-6-flash/overview"},{"title":"Справочник по нативному API Gemini 3.6 Flash","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":"/ru/api-capabilities/gemini-3-6-flash/generate-content"},{"title":"Справочник API чата Gemini 3.6 Flash","sidebarTitle":"Песочница чата 3.6","openapi":"api-reference/gemini-3-6-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ru/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":"/ru/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":"/ru/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":"/ru/api-capabilities/gemini-3-5-flash-lite/chat-completions"}]},{"group":"Серия Qwen3","icon":"puzzle","pages":[{"title":"Генерация текста Qwen3.8-Max","sidebarTitle":"Обзор","icon":"puzzle","href":"/ru/api-capabilities/qwen-3-8/overview"},{"title":"Справка по Chat API Qwen3.8-Max","sidebarTitle":"Песочница Chat","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ru/api-capabilities/qwen-3-8/chat-completions"},{"title":"Серия текстовых моделей Qwen3.6 (устаревшая)","sidebarTitle":"Qwen3.6 (устаревшая)","icon":"puzzle","href":"/ru/api-capabilities/qwen-3-6/overview"}]},{"group":"Kimi K3.1 Pro","icon":"moon","pages":[{"title":"Обзор Kimi K3.1 Pro","sidebarTitle":"Обзор","icon":"brain","href":"/ru/api-capabilities/kimi-k3-1/overview"}]},{"title":"Генерация текста Kimi K2.5","sidebarTitle":"Kimi K2.5","icon":"bot","href":"/ru/api-capabilities/kimi-k2-5"}]},{"group":"Audio API (официальный)","icon":"audio-lines","pages":[{"title":"Голосовой режим реального времени (WebSocket)","sidebarTitle":"Обзор голосового режима реального времени","icon":"audio-lines","href":"/ru/api-capabilities/realtime/overview"}]},{"group":"Поиск и безопасность","icon":"search","pages":[{"title":"API векторизации текста","icon":"vector-square","href":"/ru/api-capabilities/text-embedding"},{"title":"Практическая настройка embedding","sidebarTitle":"Настройка embedding","description":"Как действительно получать пользу от embeddings: измеренное сравнение bge-m3 с тремя моделями OpenAI, насколько крупно разбивать на фрагменты, как задавать пороги сходства, сколько использовать пакетирования и параллельных запросов, как на самом деле работает тарификация и настройка LangChain по умолчанию, которая незаметно снижает полноту с 80% до 15%.","icon":"sliders-horizontal","href":"/ru/api-capabilities/embedding-best-practices"},{"group":"Реранжирование","icon":"list-ordered","pages":[{"title":"bge-reranker-v2-m3 Переранжирование текста","sidebarTitle":"Обзор","icon":"list-ordered","href":"/ru/api-capabilities/rerank/overview"},{"title":"Справочник Rerank API","sidebarTitle":"Песочница","description":"справочник API rerank bge-reranker-v2-m3 и интерактивная песочница: параметры /v1/rerank, структура ответа, таблица кодов ошибок и заметки по отладке.","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ru/api-capabilities/rerank/rerank-api"},{"title":"Настройка RAG на практике","sidebarTitle":"Настройка RAG","icon":"sliders-horizontal","href":"/ru/api-capabilities/rerank/rag-best-practices"}]},{"title":"Модерация текста","icon":"shield-check","href":"/ru/api-capabilities/text-moderation"}]}]},{"tab":"Сценарии использования","icon":"layout-grid","pages":[{"title":"Сценарии использования","href":"/ru/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","pages":[{"title":"FAQ","href":"/ru/faq"}]},{"tab":"Обновления в реальном времени","icon":"activity","pages":[{"title":"Обновления в реальном времени","href":"/ru/live"}]},{"tab":"Объявления","icon":"megaphone","pages":[{"title":"Объявления","href":"/ru/changelog"}]},{"tab":"Акции","icon":"gift","pages":[{"title":"Акции","href":"/ru/faq/recharge-promotions"}]},{"tab":"Цены на модели","icon":"circle-dollar-sign","pages":[{"title":"Цены на модели","href":"/ru/models"}]}]}]},"title":"bge-reranker-v2-m3 Переранжирование текста - API易文档中心","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["10e4515597"],"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"]}