Эндпоинт принимает запрос и набор документов, а возвращает документы, упорядоченные по релевантности запросу. Типичное применение — второй этап поиска: сначала вы отбираете кандидатов дешёвым способом, например векторным поиском по эмбеддингам, потом переранжируете их точной моделью. Работает с моделями из каталога GET /api/v1/models, у которых в capabilities есть значение "rerank".
Сначала получите идентификатор модели из каталога, отфильтровав его по capabilities:
cURL
MODEL=$(curl -s https://speshu.ai/api/v1/models \ | jq -r '.data[] | select(.capabilities | index("rerank")) | .id' \ | head -n 1)curl https://speshu.ai/api/v1/rerank \ -H "Authorization: Bearer $SPESHU_API_KEY" \ -H "Content-Type: application/json" \ -d "{ \"model\": \"$MODEL\", \"query\": \"Как вернуть товар?\", \"documents\": [ \"Возврат товара возможен в течение 14 дней.\", \"Доставка осуществляется по всей России.\", \"Гарантия на технику — 12 месяцев.\" ], \"top_n\": 2 }"
Идентификатор модели берите из GET /api/v1/models и подставляйте как есть. Состав моделей меняется, поэтому в рабочем коде не зашивайте его литералом. Если передать идентификатор обычной текстовой модели или неизвестное значение, придёт 404 с кодом model_not_found.
Идентификатор модели из каталога с capabilities, содержащим "rerank". Обязательно
query
string
Запрос, относительно которого оценивается релевантность. Обязательно
documents
array
Документы для ранжирования: массив строк или массив объектов. Обязательно; пустой массив не принимается
documents[]
string или object
Строка с текстом документа либо объект вида {"text": ...} или {"image": ...}
top_n
integer
Сколько лучших документов вернуть. Необязательно; по умолчанию возвращаются все
В одном вызове можно смешивать документы-строки и документы-объекты. Документ-объект несёт либо text, либо image — визуальную модель, которая умеет читать изображения, можно попросить сравнить картинки с текстовым запросом.
Списание зависит от фактической стоимости вызова. Поле usage.cost — сумма, списанная с вашего баланса; оно отсутствует, если списание не зафиксировано. Фактический остаток после вызова проверяйте через GET /api/v1/balance.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Документация SpeShu.AI","colors":{"primary":"#ff7819","light":"#ff9038","dark":"#ff7819"},"logo":{"light":"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0","dark":"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0"},"favicon":"https://mintcdn.com/speshu/4vy74SrUrHtVMEav/favicon.svg?fit=max\u0026auto=format\u0026n=4vy74SrUrHtVMEav\u0026q=85\u0026s=3fe1d515b10b46d55add95c515686b24","api":{"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":"https://speshu.ai"}},"appearance":{"default":"light"},"navbar":{"links":[{"href":"/support","label":"Поддержка"}],"primary":{"type":"button","label":"Профиль","href":"https://speshu.ai/profile"}},"footer":{"links":[{"items":[{"label":"Сотрудничество","href":"mailto:info@speshu.ai"},{"label":"Написать в ТГ","href":"https://t.me/sprt_speshu_ai"},{"label":"Клуб AI-Профи","href":"https://t.me/+9Fkgdpnm3axlN2Ji"}]}]},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Модели","icon":"microchip","href":"/api-reference/media/models"},{"anchor":"Каталог","icon":"list","href":"/models"},{"anchor":"Профиль","icon":"gauge","href":"https://speshu.ai/profile"},{"anchor":"Поддержка","icon":"headset","href":"/support"}]},"languages":[{"language":"ru","href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"speshu","hasAudioNarration":false,"actualSubdomain":"speshu","customDomains":["speshu.ai"],"gitSource":{"type":"github","owner":"laoboost","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad74369dcf1b2c01a0bc747","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"ru","tag":"Руководства","count":41},{"language":"ru","tag":"API Reference","count":23},{"language":"ru","tag":"Документация","count":13},{"language":"ru","tag":"Фреймворки","count":12},{"language":"ru","tag":"Текстовая генерация","count":7},{"language":"ru","tag":"Агенты и редакторы","count":7},{"language":"ru","tag":"Медиа","count":6},{"language":"ru","tag":"О сервисе","count":6},{"language":"ru","tag":"Возможности моделей","count":6},{"language":"ru","tag":"Начало","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/rerank/create","slug":"/api-reference/rerank/create","pageMetadata":{"title":"Ранжирование","description":"POST /api/v1/rerank — оценка релевантности документов относительно запроса","openapi":"api-reference/openapi.json POST /api/v1/rerank","playground":"interactive","icon":"arrow-down-short-wide","href":"/api-reference/rerank/create"},"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: \"POST /api/v1/rerank — оценка релевантности документов относительно запроса\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Note,Table}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Эндпоинт принимает запрос и набор документов, а возвращает документы, упорядоченные по релевантности запросу. Типичное применение — второй этап поиска: сначала вы отбираете кандидатов дешёвым способом, например векторным поиском по эмбеддингам, потом переранжируете их точной моделью. Работает с моделями из каталога `,_jsx(_components.code,{children:`GET /api/v1/models`}),`, у которых в `,_jsx(_components.code,{children:`capabilities`}),` есть значение `,_jsx(_components.code,{children:`\"rerank\"`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`минимальный-запрос`,children:`Минимальный запрос`}),`\n`,_jsxs(_components.p,{children:[`Сначала получите идентификатор модели из каталога, отфильтровав его по `,_jsx(_components.code,{children:`capabilities`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`17`,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:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`MODEL`}),_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:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://speshu.ai/api/v1/models`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -r`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '.data[] | select(.capabilities | index(\"rerank\")) | .id'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` head`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -n`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_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:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://speshu.ai/api/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:`$SPESHU_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`model`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$MODEL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`query`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Как вернуть товар?`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`documents`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Возврат товара возможен в течение 14 дней.`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Доставка осуществляется по всей России.`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Гарантия на технику — 12 месяцев.`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`top_n`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`: 2`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }\"`})}),`\n`]})})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Идентификатор модели берите из `,_jsx(_components.code,{children:`GET /api/v1/models`}),` и подставляйте `,_jsx(_components.strong,{children:`как есть`}),`. Состав моделей меняется, поэтому в рабочем коде не зашивайте его литералом. Если передать идентификатор обычной текстовой модели или неизвестное значение, придёт `,_jsx(_components.code,{children:`404`}),` с кодом `,_jsx(_components.code,{children:`model_not_found`}),`.`]})}),`\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:`Описание`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`Идентификатор модели из каталога с `,_jsx(_components.code,{children:`capabilities`}),`, содержащим `,_jsx(_components.code,{children:`\"rerank\"`}),`. Обязательно`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`query`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Запрос, относительно которого оценивается релевантность. Обязательно`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`documents`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Документы для ранжирования: массив строк или массив объектов. Обязательно; пустой массив не принимается`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`documents[]`})}),_jsx(_components.td,{children:`string или object`}),_jsxs(_components.td,{children:[`Строка с текстом документа либо объект вида `,_jsx(_components.code,{children:`{\"text\": ...}`}),` или `,_jsx(_components.code,{children:`{\"image\": ...}`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`top_n`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Сколько лучших документов вернуть. Необязательно; по умолчанию возвращаются все`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`В одном вызове можно смешивать документы-строки и документы-объекты. Документ-объект несёт либо `,_jsx(_components.code,{children:`text`}),`, либо `,_jsx(_components.code,{children:`image`}),` — визуальную модель, которая умеет читать изображения, можно попросить сравнить картинки с текстовым запросом.`]}),`\n`,_jsx(Heading,{level:`2`,id:`ответ`,children:`Ответ`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`200 OK`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`21`,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:`21`,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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"rer-...\"`}),_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:` \"model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"идентификатор-модели\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\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`,_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:` \"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:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,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.97`}),_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:` \"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:`\"Возврат товара возможен в течение 14 дней.\"`}),_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`,_jsxs(_components.span,{className:`line`,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:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,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.21`}),_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:` \"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:`\"Гарантия на технику — 12 месяцев.\"`}),_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`,_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:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"search_units\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_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:` \"total_tokens\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`150`}),_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:` \"cost\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0.00012`})]}),`\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`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{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:`results`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`Документы, упорядоченные от самых релевантных к менее релевантным`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].index`})}),_jsx(_components.td,{children:`integer`}),_jsxs(_components.td,{children:[`Позиция документа в массиве `,_jsx(_components.code,{children:`documents`}),` запроса — связывает результат с его документом`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].relevance_score`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Оценка релевантности, от 0 до 1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`results[].document`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{children:`Документ, как он пришёл в запросе`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`usage.search_units`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Израсходованные единицы поиска (биллинговая единица части провайдеров)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`usage.total_tokens`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`Суммарные токены, обработанные моделью`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`usage.cost`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`Сумма, списанная с вашего баланса за вызов. Поле отсутствует, если списание не зафиксировано`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`С `,_jsx(_components.code,{children:`top_n`}),` возвращаются только первые `,_jsx(_components.code,{children:`top_n`}),` позиций, но оценить модель может весь набор — порядок в `,_jsx(_components.code,{children:`results`}),` остаётся порядком убывания релевантности.`]}),`\n`,_jsx(Heading,{level:`3`,id:`стоимость`,children:`Стоимость`}),`\n`,_jsxs(_components.p,{children:[`Списание зависит от фактической стоимости вызова. Поле `,_jsx(_components.code,{children:`usage.cost`}),` — сумма, списанная с вашего баланса; оно отсутствует, если списание не зафиксировано. Фактический остаток после вызова проверяйте через `,_jsx(_components.code,{children:`GET /api/v1/balance`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`проверки-перед-вызовом`,children:`Проверки перед вызовом`}),`\n`,_jsx(_components.p,{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:_jsx(_components.code,{children:`401 invalid_api_key`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Модель не из списка моделей ранжирования`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`404 model_not_found`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Не хватает денег`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`402 insufficient_quota`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Нет `,_jsx(_components.code,{children:`model`}),` или `,_jsx(_components.code,{children:`query`}),`, пустой `,_jsx(_components.code,{children:`documents`}),`, документ без `,_jsx(_components.code,{children:`text`}),` и `,_jsx(_components.code,{children:`image`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`400 invalid_request`})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Ошибки приходят в конверте OpenAI — объект `,_jsx(_components.code,{children:`error`}),` с полями `,_jsx(_components.code,{children:`message`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`param`}),` и `,_jsx(_components.code,{children:`code`}),`. Полная таблица кодов — на странице `,_jsx(_components.a,{href:`/errors`,children:`Ошибки`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`что-дальше`,children:`Что дальше`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Каталог моделей`,icon:`microchip`,href:`/api-reference/models/list`,children:_jsx(_components.p,{children:`Фильтр по capabilities и цены моделей`})}),_jsx(Card,{title:`Эмбеддинги`,icon:`circle-nodes`,href:`/api-reference/embeddings/create`,children:_jsx(_components.p,{children:`Векторный поиск как первый этап отбора`})}),_jsx(Card,{title:`Баланс`,icon:`wallet`,href:`/api-reference/other/balance`,children:_jsx(_components.p,{children:`Остаток кошелька по валютам`})}),_jsx(Card,{title:`Ошибки`,icon:`triangle-exclamation`,href:`/errors`,children:_jsx(_components.p,{children:`Полная таблица кодов`})})]})]})}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":"Ранжирование","description":"POST /api/v1/rerank — оценка релевантности документов относительно запроса","openapi":"api-reference/openapi.json POST /api/v1/rerank","playground":"interactive","icon":"arrow-down-short-wide","href":"/api-reference/rerank/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"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":[],"openApiReferenceData":{"operation":{"tags":["Текст"],"operationId":"createRerank","summary":"Ранжирование","description":"POST /api/v1/rerank — оценка релевантности документов относительно запроса","requestBody":"eb32f8a4-c41d-400a-8fd3-229099d5ba1b","responses":{"200":"6b3e8c88-af29-4b03-91ea-abdb81972307","400":"1a2d7f39-964a-423e-a779-4e8ee0a7ac47","401":"641eb1fe-6b06-4096-ab1d-0a5cd17bc259","402":"82945121-519e-4894-813a-4d72cf09dba4","403":"69301b18-bae2-4db6-9e7c-372e7be2198e","404":"3210a9d0-b48c-41e3-98e9-aaaa6ac602c5","422":"a1b25cac-afa0-4a5c-b9de-0bfe1c43ec55","429":"358b8fbd-973c-400e-bfc3-a7f1c290215f","499":"8024fe76-84b7-4509-950b-ea921252a6a1","500":"b5977d83-e1a5-4a65-81e2-1c3f747acad0","502":"9db9abfa-8e09-4621-b334-424803f86311","503":"d6df6e45-cb93-4456-826d-19e1633bfe3a","504":"e377cace-c518-498c-91cf-ac0d3cc29f66"},"method":"post","type":"path","servers":["8a2807ef-ac4b-47e6-8d72-307eede96316"],"security":["e2ba089c-3a25-43cf-af05-e084bb9608e5"],"path":"/api/v1/rerank","baseUrlOptions":["https://speshu.ai"],"title":"Ранжирование","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","query","documents"],"properties":{"model":{"type":"string","description":"Идентификатор модели из GET /api/v1/models: у неё в capabilities есть значение \"rerank\". Передаётся как есть.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"query":{"type":"string","description":"Запрос, относительно которого оценивается релевантность.","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"documents":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"documents.items.[INDEX]","typeLabel":"any"},"description":"Документы: строки или объекты вида {\"text\": ...} / {\"image\": ...}. Пустой массив не принимается.","isRequired":true,"uniqueKey":"documents","typeLabel":"any[]"},"top_n":{"type":"integer","description":"Сколько лучших документов вернуть. По умолчанию возвращаются все.","uniqueKey":"top_n","typeLabel":"integer"},"user":{"type":"string","maxLength":256,"description":"Идентификатор пользователя на вашей стороне. Необязательно.","uniqueKey":"user","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"\u003cstring>","query":"\u003cstring>","documents":["\u003cunknown>"],"top_n":123,"user":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6b3e8c88-af29-4b03-91ea-abdb81972307":{"description":"Документы, упорядоченные по релевантности.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"model":{"type":"string","description":"Идентификатор модели.","uniqueKey":"model","typeLabel":"string"},"results":{"type":"array","description":"Документы, упорядоченные по убыванию релевантности.","items":{"type":"object","properties":{"index":{"type":"integer","description":"Позиция документа в массиве documents запроса.","isRequired":true,"uniqueKey":"results.items.[INDEX].index","typeLabel":"integer"},"relevance_score":{"type":"number","description":"Оценка релевантности от 0 до 1.","isRequired":true,"uniqueKey":"results.items.[INDEX].relevance_score","typeLabel":"number"},"document":{"description":"Документ, как он пришёл в запросе.","isRequired":true,"uniqueKey":"results.items.[INDEX].document","typeLabel":"any"}},"required":["index","relevance_score","document"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"},"usage":{"type":"object","properties":{"search_units":{"type":"integer","description":"Израсходованные единицы поиска (биллинговая единица части провайдеров).","uniqueKey":"usage.search_units","typeLabel":"integer"},"total_tokens":{"type":"integer","description":"Суммарные токены, обработанные моделью.","uniqueKey":"usage.total_tokens","typeLabel":"integer"},"cost":{"type":"number","description":"Сумма, списанная с вашего баланса за вызов. Отсутствует, если списание не зафиксировано.","uniqueKey":"usage.cost","typeLabel":"number"}},"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","model":"\u003cstring>","results":[{"index":123,"relevance_score":123,"document":"\u003cunknown>"}],"usage":{"search_units":123,"total_tokens":123,"cost":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"1a2d7f39-964a-423e-a779-4e8ee0a7ac47":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"641eb1fe-6b06-4096-ab1d-0a5cd17bc259":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"82945121-519e-4894-813a-4d72cf09dba4":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"69301b18-bae2-4db6-9e7c-372e7be2198e":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3210a9d0-b48c-41e3-98e9-aaaa6ac602c5":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a1b25cac-afa0-4a5c-b9de-0bfe1c43ec55":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"358b8fbd-973c-400e-bfc3-a7f1c290215f":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"8024fe76-84b7-4509-950b-ea921252a6a1":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"b5977d83-e1a5-4a65-81e2-1c3f747acad0":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"9db9abfa-8e09-4621-b334-424803f86311":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d6df6e45-cb93-4456-826d-19e1633bfe3a":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e377cace-c518-498c-91cf-ac0d3cc29f66":{"description":"Ошибка в формате OpenAI.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","examples":["invalid_request_error"],"description":"`authentication_error` при 401, `rate_limit_error` при 429, `permission_error` при 403, в остальных случаях `invalid_request_error`, `api_error` или `internal_error`.","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"param":{"oneOf":[{"type":"string","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.0","typeLabel":"string"},{"type":"null","examples":["invalid_request"],"description":"Машиночитаемый код: `invalid_api_key`, `unauthorized`, `insufficient_quota`, `rate_limit_exceeded`, `token_limit_exceeded`, `content_too_large`, `limit_exceeded`, `model_not_found`, `no_providers`, `service_unavailable`, `provider_error`, `invalid_request`, `context_length_exceeded`, `internal_error`.","uniqueKey":"error.code.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.code","typeLabel":"string | null"}},"required":["message","type"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","type":"invalid_request_error","param":"\u003cstring>","code":"invalid_request"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e2ba089c-3a25-43cf-af05-e084bb9608e5":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"8a2807ef-ac4b-47e6-8d72-307eede96316":{"url":"https://speshu.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API-ключ в формате `sk-...`. Альтернативно — заголовок `X-Api-Key: sk-...` (совместимо с Anthropic SDK).","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"speshu","siteName":"Документация SpeShu.AI","title":"Ранжирование - Документация SpeShu.AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ru":{"href":"/api-reference/rerank/create","matchLevel":0}}},"lastModified":"2026-10-12T18:30:51.651Z","originalFileLocation":"api-reference/rerank/create.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=\"light\"}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=\"POST /api/v1/rerank — оценка релевантности документов относительно запроса\">\u003cmeta data-mint-head name=\"application-name\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_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=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ранжирование - Документация SpeShu.AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /api/v1/rerank — оценка релевантности документов относительно запроса\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://speshu.ai/docs/api-reference/rerank/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://speshu.mintlify.site/docs/_mintlify/api/og/v2?division=%D0%A2%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D0%B0%D1%8F+%D0%B3%D0%B5%D0%BD%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F\u0026amp;title=%D0%A0%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5\u0026amp;description=POST+%2Fapi%2Fv1%2Frerank+%E2%80%94+%D0%BE%D1%86%D0%B5%D0%BD%D0%BA%D0%B0+%D1%80%D0%B5%D0%BB%D0%B5%D0%B2%D0%B0%D0%BD%D1%82%D0%BD%D0%BE%D1%81%D1%82%D0%B8+%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%BE%D0%B2+%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%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0\u0026amp;theme=e30006b63b476fd6b922259f\u0026amp;signature=9694891112f24ab628560d0268816628b2c0c1dfdbc6dfca8a9fcbf8cd6bcca8\">\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=\"Ранжирование - Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /api/v1/rerank — оценка релевантности документов относительно запроса\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://speshu.mintlify.site/docs/_mintlify/api/og/v2?division=%D0%A2%D0%B5%D0%BA%D1%81%D1%82%D0%BE%D0%B2%D0%B0%D1%8F+%D0%B3%D0%B5%D0%BD%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F\u0026amp;title=%D0%A0%D0%B0%D0%BD%D0%B6%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5\u0026amp;description=POST+%2Fapi%2Fv1%2Frerank+%E2%80%94+%D0%BE%D1%86%D0%B5%D0%BD%D0%BA%D0%B0+%D1%80%D0%B5%D0%BB%D0%B5%D0%B2%D0%B0%D0%BD%D1%82%D0%BD%D0%BE%D1%81%D1%82%D0%B8+%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%BE%D0%B2+%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%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0\u0026amp;theme=e30006b63b476fd6b922259f\u0026amp;signature=9694891112f24ab628560d0268816628b2c0c1dfdbc6dfca8a9fcbf8cd6bcca8\">\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=\"/docs/mintlify-assets/_mintlify/favicons/speshu/h8uCrMo0u7Pj0sRw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Документация SpeShu.AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff7819\">\u003clink data-mint-head rel=\"canonical\" href=\"https://speshu.ai/docs/api-reference/rerank/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/rerank/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://speshu.ai/#organization\",\"name\":\"Документация SpeShu.AI\",\"url\":\"https://speshu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/speshu/HiupqL5TwnvMFufM/logo/speshu_logo.png?fit=max\u0026auto=format\u0026n=HiupqL5TwnvMFufM\u0026q=85\u0026s=fd0fe3cc5f642899ca9d4e8bdee6a0f0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://speshu.ai/docs#website\",\"name\":\"Документация SpeShu.AI\",\"url\":\"https://speshu.ai/docs\",\"publisher\":{\"@id\":\"https://speshu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://speshu.ai/docs/api-reference/rerank/create#webpage\",\"url\":\"https://speshu.ai/docs/api-reference/rerank/create\",\"name\":\"Ранжирование\",\"description\":\"POST /api/v1/rerank — оценка релевантности документов относительно запроса\",\"dateModified\":\"2026-10-12T18:30:51.651Z\",\"isPartOf\":{\"@id\":\"https://speshu.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://speshu.ai/docs/api-reference/rerank/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://speshu.ai/docs/api-reference/rerank/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Текстовая генерация\",\"item\":\"https://speshu.ai/docs/api-reference/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ранжирование\",\"item\":\"https://speshu.ai/docs/api-reference/rerank/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://speshu.ai/docs/api-reference/rerank/create#apireference\",\"headline\":\"Ранжирование\",\"name\":\"Ранжирование\",\"description\":\"POST /api/v1/rerank — оценка релевантности документов относительно запроса\",\"url\":\"https://speshu.ai/docs/api-reference/rerank/create\",\"mainEntityOfPage\":{\"@id\":\"https://speshu.ai/docs/api-reference/rerank/create#webpage\"},\"dateModified\":\"2026-10-12T18:30:51.651Z\",\"publisher\":{\"@id\":\"https://speshu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://speshu.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Документация SpeShu.AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Документация SpeShu.AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/rerank/create.md","siteName":"Документация SpeShu.AI","nav":{"global":{"anchors":[{"anchor":"Модели","icon":"microchip","href":"/api-reference/media/models"},{"anchor":"Каталог","icon":"list","href":"/models"},{"anchor":"Профиль","icon":"gauge","href":"https://speshu.ai/profile"},{"anchor":"Поддержка","icon":"headset","href":"/support"}]},"languages":[{"language":"ru","tabs":[{"tab":"Документация","pages":[{"title":"Документация","href":""}]},{"tab":"Руководства","pages":[{"title":"Руководства","href":"/gaidy/getting-started"}]},{"tab":"API Reference","groups":[{"group":"Текстовая генерация","pages":[{"title":"Введение в API","icon":"book","href":"/api-reference/introduction"},{"title":"Запрос чату","openapi":"api-reference/openapi.json POST /api/v1/chat/completions","playground":"interactive","icon":"message","href":"/api-reference/chat/completions"},{"title":"Responses","openapi":"api-reference/openapi.json POST /api/v1/responses","icon":"list","href":"/api-reference/responses/create"},{"title":"Anthropic Messages","openapi":"api-reference/openapi.json POST /api/v1/messages","icon":"a","href":"/api-reference/messages/create"},{"title":"Оценка решений","openapi":"api-reference/openapi.json POST /api/v1/decisions","playground":"interactive","icon":"scale-balanced","href":"/api-reference/decisions/create"},{"title":"Эмбеддинги","description":"POST /api/v1/embeddings — векторные представления текста для поиска, классификации и кластеризации","openapi":"api-reference/openapi.json POST /api/v1/embeddings","playground":"interactive","icon":"circle-nodes","href":"/api-reference/embeddings/create"},{"title":"Ранжирование","openapi":"api-reference/openapi.json POST /api/v1/rerank","playground":"interactive","icon":"arrow-down-short-wide","href":"/api-reference/rerank/create"}]},{"group":"Инструменты","pages":[{"title":"Поиск в интернете","description":"POST /api/v1/tools/search — поиск страниц в интернете по текстовому запросу","openapi":"api-reference/openapi.json POST /api/v1/tools/search","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/tools/search"},{"title":"Загрузка страницы","openapi":"api-reference/openapi.json POST /api/v1/tools/fetch","playground":"interactive","icon":"file-lines","href":"/api-reference/tools/fetch"}]},{"group":"Аудио","pages":[{"title":"Синтез речи","openapi":"api-reference/openapi.json POST /api/v1/audio/speech","playground":"interactive","icon":"volume-high","href":"/api-reference/audio/speech"},{"title":"Распознавание речи","openapi":"api-reference/openapi.json POST /api/v1/audio/transcriptions","playground":"interactive","icon":"microphone","href":"/api-reference/audio/transcriptions"}]},{"group":"Медиа","pages":[{"title":"Создать задачу","openapi":"api-reference/openapi.json POST /api/v1/async/media/tasks","playground":"interactive","icon":"plus","href":"/api-reference/media/create"},{"title":"Статус задачи","openapi":"api-reference/openapi.json GET /api/v1/async/media/tasks/{task_id}","icon":"magnifying-glass","href":"/api-reference/media/status"},{"title":"Список задач","openapi":"api-reference/openapi.json GET /api/v1/async/media/tasks","icon":"list","href":"/api-reference/media/list"},{"title":"Жизненный цикл задачи","openapi":"/api-reference/openapi.json","icon":"rotate","href":"/api-reference/media/tasks"},{"title":"Медиа-сессии","icon":"folder","href":"/api-reference/media/sessions"},{"title":"Каталог медиа-моделей","openapi":"api-reference/openapi.json GET /api/v1/media/models","icon":"microchip","href":"/api-reference/media/models"}]},{"group":"Хранилище","pages":[{"title":"Загрузить файл","openapi":"api-reference/openapi.json POST /api/v1/storage/upload","playground":"interactive","icon":"upload","href":"/api-reference/storage/upload"},{"title":"Список файлов","openapi":"api-reference/openapi.json GET /api/v1/storage","playground":"interactive","icon":"list","href":"/api-reference/storage/list"},{"title":"Метаданные файла","openapi":"api-reference/openapi.json GET /api/v1/storage/{id}","playground":"interactive","icon":"magnifying-glass","href":"/api-reference/storage/get"},{"title":"Удалить файл","openapi":"api-reference/openapi.json DELETE /api/v1/storage/{id}","icon":"trash","href":"/api-reference/storage/delete"}]},{"group":"Модели и баланс","pages":[{"title":"Каталог моделей","openapi":"api-reference/openapi.json GET /api/v1/models","playground":"interactive","icon":"microchip","href":"/api-reference/models/list"},{"title":"Баланс","openapi":"api-reference/openapi.json GET /api/v1/balance","playground":"interactive","icon":"wallet","href":"/api-reference/other/balance"}]}]}]}]},"basePath":"","title":"Ранжирование - Документация SpeShu.AI","buildId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","deploymentId":"dpl_2AK98Hxhwu4fUXpx9atbv41cC328","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-EBSrFTg1.js","utils-Y_7TcRh4.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D1wvvkPH.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-aT0ty6oN.js","snippetPresets-DoNRuyJc.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DCFaZE46.js","ApiExamples-CXRajFpn.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BAyOsINj.js","shallow-CIcHqV1v.js","getApiPlaygroundDisplay-C5igZwEf.js","CodeSnippet-BFWnQLNh.js","CodeSnippets-Cx2mFgZW.js","getPastedJson-BOy09PZp.js","icon-BwmYtB6R.js","MethodPill-DAIhq-iu.js","DuplicateIcon-DFM8Q3ph.js","createIcon-0UdvzB4Z.js","DynamicMarkdown-DYYZTGpa.js","SectionHeading-BFCDRUuH.js","axios-vUo_bRtp.js","Markdown-C6TcKjiR.js","clsx-Y_UC780V.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-PCbBHBTv.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D4q_oRML.js"]}