Что такое механизм предварительного списания для API-вызовов?
Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.
Перед тем как запрос фактически выполняется, APIYI рассчитывает предварительное удержание («цена модели × предполагаемые token» — максимальная возможная стоимость) и временно блокирует эту сумму на вашем балансе. Когда запрос завершается, система производит окончательный расчет по фактически использованным tokens и возвращает разницу — предварительное удержание это только оценка, а не итоговый счет.
Две ключевые строки
Предварительное удержание: предварительная оценка перед запросом, которая используется, чтобы понять, «можете ли вы оплатить этот вызов».
Фактическая тарификация: окончательный расчет по реальным token после завершения запроса — именно это и списывается по-настоящему.
Если оценка предварительного удержания > ваш текущий баланс, запрос отклоняется еще до запуска, и возвращается insufficient_user_quota. Это и есть основная причина ситуации «баланс у меня явно есть, но запрос все равно не проходит».
Система читает ваш input (prompt, изображения, историю переписки и т. д.) и, используя текущую цену модели и оценочную длину output, вычисляет максимально возможную стоимость и временно удерживает ее из вашего баланса.Оценка примерно такая:pre-deduction ≈ model price × (input tokens + estimated output tokens)
2
Проверка перед отправкой: достаточно ли баланса
Она сравнивает предварительное списание с вашим текущим балансом:
balance ≥ pre-deduction → разрешено, запрос отправляется
balance < pre-deduction → отклонено с insufficient_user_quota, и вызов фактически не выполняется
3
После запроса: расчет по факту, возврат разницы
После завершения система берет фактическое использование token для input/output и пересчитывает списание по факту:
фактическая стоимость обычно меньше, чем pre-deduction → излишне удержанная квота возвращается на ваш баланс
неудачные/прерванные запросы → как правило, не тарифицируются, а удержанная квота освобождается
Большое предварительное списание не означает, что вы действительно потратили столько же — это оценка в формате «резерв на худший случай». Фактически списываются actual token после завершения запроса.
Когда предварительное списание превышает ваш баланс, вы увидите примерно такое:
{ "error": { "message": "user [25359] quota [50264897] preConsumedQuota [154753475] is not enough", "localized_message": "Insufficient user quota", "type": "shell_api_error", "param": "", "code": "insufficient_user_quota" }}
По полям:
Поле
Значение
quota [50264897]
Ваш текущий доступный баланс (внутренняя единица квоты)
preConsumedQuota [154753475]
Квота, которую этот запрос хочет предварительно списать
is not enough
предварительное списание > баланс, недостаточно для удержания, запрос отклонен
code: insufficient_user_quota
Код ошибки: недостаточная квота пользователя
Важно именно соотношение между двумя числами: здесь предварительное списание 154753475 примерно в 3× больше баланса 50264897, поэтому оно блокируется.
Эти числа — это внутренние единицы квоты APIYI, и их можно напрямую сравнивать. В долларовом выражении: баланс ≈ $100, оценка предварительного списания для этого запроса ≈ $310 (внутри системы ~500,000 единиц ≈ $1). Иными словами, этот единственный запрос попытался удержать более $300, хотя на счете было только $100 — поэтому он не смог выполниться.
Почему «у меня есть баланс, но это не запускается»
В подавляющем большинстве случаев проблема в слишком большом input, а не в самом балансе.Реальный пример: gpt-5.5 имеет контекстное окно до 1,050,000 tokens. Если загрузить туда весь большой code repository, количество input token становится огромным, и предварительное списание резко возрастает — даже при балансе в $100 оценка в $300 все равно будет отклонена еще до запуска запроса.
Чем больше input, тем выше предварительное списаниеСлишком большой input не только увеличивает предварительное списание и легко вызывает insufficient_user_quota, но и:
даже если запрос пройдет, фактическая стоимость будет высокой (тарификация идет по реальным token);
если загрузить слишком много нерелевантного контента, модель может вернуть посредственный результат — деньги потрачены, а результат слабый.
Отправляйте только релевантный код/документацию — не загружайте весь репозиторий или длинный документ целиком. Это самый эффективный способ исправить проблему.
Установите max_tokens
Явно ограничьте длину вывода, чтобы снизить «оценочное количество output tokens» и, соответственно, предварительное списание. См. руководство по max_tokens.
Пополните баланс
Если вам действительно нужен большой входной объем, просто убедитесь, что баланс > предварительное списание. См. способы оплаты.
Сначала протестируйте на небольшой модели
Проверьте, что ваш входной объем разумен для дешевой модели, а затем переключитесь на более дорогую — не допускайте «сжигания больше, чем вы можете себе позволить».
Будьте осторожны с большими входными данными: модели с большим контекстным окном (например, у gpt-5.5 1.05M tokens) могут удерживать очень много, но «могут удерживать» не означает «должны удерживать». Запихивать в них весь репозиторий часто и дорого, и посредственно — сначала подумайте, какой контекст вам действительно нужен.
Действительно ли предварительное списание спишет такую сумму?
Нет. Предварительное списание — это лишь временное удержание перед запросом; окончательное списание определяется фактическим использованием token после завершения запроса, а излишне удержанная часть возвращается. preConsumedQuota, который вы видите, — это оценка «резерв на худший случай», а не реальный счет.
Будет ли с меня списание, если запрос завершится ошибкой?
Обычно нет. Ошибка insufficient_user_quota блокируется до выполнения, поэтому модель фактически не вызывается, реальных затрат не возникает, а удержанная квота освобождается.
На балансе явно достаточно средств — почему возникает ошибка квоты?
В этой ошибке сравнивается предварительное списание с вашим балансом, а не «фактическая стоимость» с балансом. Слишком большой ввод делает оценку предварительного списания намного выше вашего баланса, поэтому запрос отклоняется. Сначала сократите ввод или задайте max_tokens, чтобы снизить оценку вывода, и пополните баланс, если этого все еще недостаточно.
Всегда ли модели с большим контекстным окном дороже?
Базовая цена модели задается самой моделью — большее окно ≠ более высокая цена за единицу. Но большее окно означает, что вы можете передать больше ввода, и когда вы действительно заполняете его, количество input tokens резко растет, и как предварительное списание, так и фактическая стоимость становятся высокими. Дорого стоит не само окно, а «сколько вы в него помещаете».
Почему запрос не выполняется, несмотря на наличие баланса?
Полное руководство по устранению проблем и исправлению недостаточного баланса.
Как задать max_tokens?
Управление длиной вывода, которая влияет на предварительную оценку списания.
Узнайте фактическую стоимость видеозадачи по task_id
Взаимосвязь записей о предварительном списании и окончательном расчёте с квотой задачи.
Режимы тарификации token
Узнайте, как работает расчёт на основе использования.
Способы оплаты
Как быстро пополнить баланс при его недостаточном объёме.
Была ли эта страница полезной?
{"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":"6add7fffcc3d3d50f778c313","collectionId":"cf61f539-88bb-4b4e-b17b-a9261eb652a0","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6add7fffcc3d3d50f778c313"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6add7fffcc3d3d50f778c313","clientVersion":"0.0.3965","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":75},{"language":"en","tag":"Announcements","count":75},{"language":"zh","tag":"AI风向标","count":72},{"language":"en","tag":"AI Radar","count":72},{"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":49},{"language":"en","tag":"Use Cases","count":49},{"language":"ja","tag":"活用例","count":49},{"language":"ko","tag":"활용 사례","count":49},{"language":"ru","tag":"Сценарии использования","count":49},{"language":"zh-Hant","tag":"使用場景","count":49},{"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":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":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/faq/pre-deduction-quota","slug":"/ru/faq/pre-deduction-quota","pageMetadata":{"title":"Что такое механизм предварительного списания для API-вызовов?","description":"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.","icon":"calculator","href":"/ru/faq/pre-deduction-quota"},"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: \"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\"\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`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,Heading,Info,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`краткий-ответ`,children:`Краткий ответ`}),`\n`,_jsxs(_components.p,{children:[`Перед тем как запрос `,_jsx(_components.strong,{children:`фактически выполняется`}),`, APIYI рассчитывает `,_jsx(_components.strong,{children:`предварительное удержание`}),` («цена модели × предполагаемые token» — максимальная возможная стоимость) и временно блокирует эту сумму на вашем балансе. Когда запрос завершается, система `,_jsx(_components.strong,{children:`производит окончательный расчет по фактически использованным tokens и возвращает разницу`}),` — предварительное удержание это только оценка, а не итоговый счет.`]}),`\n`,_jsxs(Info,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Две ключевые строки`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Предварительное удержание`}),`: предварительная оценка перед запросом, которая используется, чтобы понять, «можете ли вы оплатить этот вызов».`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Фактическая тарификация`}),`: окончательный расчет по реальным token после завершения запроса — именно это и списывается по-настоящему.`]}),`\n`]})]}),`\n`,_jsxs(_components.p,{children:[`Если `,_jsx(_components.strong,{children:`оценка предварительного удержания > ваш текущий баланс`}),`, запрос отклоняется еще до запуска, и возвращается `,_jsx(_components.code,{children:`insufficient_user_quota`}),`. Это и есть основная причина ситуации «баланс у меня явно есть, но запрос все равно не проходит».`]}),`\n`,_jsx(Heading,{level:`2`,id:`как-работает-предварительное-списание`,children:`Как работает предварительное списание`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Перед запросом: оценка и удержание`,children:[_jsxs(_components.p,{children:[`Система читает ваш `,_jsx(_components.strong,{children:`input`}),` (prompt, изображения, историю переписки и т. д.) и, используя текущую цену модели и `,_jsx(_components.strong,{children:`оценочную длину output`}),`, вычисляет `,_jsx(_components.strong,{children:`максимально возможную стоимость`}),` и временно удерживает ее из вашего баланса.`]}),_jsx(_components.p,{children:`Оценка примерно такая:`}),_jsx(_components.p,{children:_jsx(_components.code,{children:`pre-deduction ≈ model price × (input tokens + estimated output tokens)`})})]}),_jsxs(Step,{title:`Проверка перед отправкой: достаточно ли баланса`,children:[_jsxs(_components.p,{children:[`Она сравнивает `,_jsx(_components.strong,{children:`предварительное списание`}),` с вашим `,_jsx(_components.strong,{children:`текущим балансом`}),`:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`balance ≥ pre-deduction → разрешено, запрос отправляется`}),`\n`,_jsxs(_components.li,{children:[`balance \u003c pre-deduction → отклонено с `,_jsx(_components.code,{children:`insufficient_user_quota`}),`, и `,_jsx(_components.strong,{children:`вызов фактически не выполняется`})]}),`\n`]})]}),_jsxs(Step,{title:`После запроса: расчет по факту, возврат разницы`,children:[_jsx(_components.p,{children:`После завершения система берет фактическое использование token для input/output и пересчитывает списание по факту:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`фактическая стоимость `,_jsx(_components.strong,{children:`обычно меньше`}),`, чем pre-deduction → излишне удержанная квота `,_jsx(_components.strong,{children:`возвращается`}),` на ваш баланс`]}),`\n`,_jsx(_components.li,{children:`неудачные/прерванные запросы → как правило, не тарифицируются, а удержанная квота освобождается`}),`\n`]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Большое предварительное списание не означает, что вы действительно потратили столько же`}),` — это оценка в формате «резерв на худший случай». Фактически списываются actual token после завершения запроса.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`чтение-ошибки-insufficient_user_quota`,children:`Чтение ошибки insufficient_user_quota`}),`\n`,_jsx(_components.p,{children:`Когда предварительное списание превышает ваш баланс, вы увидите примерно такое:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,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:` \"error\"`}),_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:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"user [25359] quota [50264897] preConsumedQuota [154753475] is not enough\"`}),_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:` \"localized_message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Insufficient user quota\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"shell_api_error\"`}),_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:` \"param\"`}),_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:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"insufficient_user_quota\"`})]}),`\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`,_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.code,{children:`quota [50264897]`})}),_jsxs(_components.td,{children:[`Ваш `,_jsx(_components.strong,{children:`текущий доступный баланс`}),` (внутренняя единица квоты)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`preConsumedQuota [154753475]`})}),_jsx(_components.td,{children:_jsx(_components.strong,{children:`Квота, которую этот запрос хочет предварительно списать`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`is not enough`})}),_jsxs(_components.td,{children:[`предварительное списание > баланс, недостаточно для удержания, `,_jsx(_components.strong,{children:`запрос отклонен`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`code: insufficient_user_quota`})}),_jsx(_components.td,{children:`Код ошибки: недостаточная квота пользователя`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Важно именно `,_jsx(_components.strong,{children:`соотношение`}),` между двумя числами: здесь предварительное списание `,_jsx(_components.code,{children:`154753475`}),` примерно в `,_jsx(_components.strong,{children:`3×`}),` больше баланса `,_jsx(_components.code,{children:`50264897`}),`, поэтому оно блокируется.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Эти числа — это `,_jsx(_components.strong,{children:`внутренние единицы квоты`}),` APIYI, и их можно напрямую сравнивать. В долларовом выражении: баланс ≈ $100, оценка предварительного списания для этого запроса ≈ $310 (внутри системы ~500,000 единиц ≈ $1). Иными словами, этот единственный запрос попытался удержать более $300, хотя на счете было только $100 — поэтому он не смог выполниться.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`почему-«у-меня-есть-баланс-но-это-не-запускается»`,children:`Почему «у меня есть баланс, но это не запускается»`}),`\n`,_jsxs(_components.p,{children:[`В подавляющем большинстве случаев `,_jsx(_components.strong,{children:`проблема в слишком большом input`}),`, а не в самом балансе.`]}),`\n`,_jsxs(_components.p,{children:[`Реальный пример: `,_jsx(_components.code,{children:`gpt-5.5`}),` имеет контекстное окно до 1,050,000 tokens. Если загрузить туда `,_jsx(_components.strong,{children:`весь большой code repository`}),`, количество input token становится огромным, и предварительное списание резко возрастает — даже при балансе в $100 оценка в $300 все равно будет отклонена еще до запуска запроса.`]}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Чем больше input, тем выше предварительное списание`})}),_jsxs(_components.p,{children:[`Слишком большой input не только увеличивает предварительное списание и легко вызывает `,_jsx(_components.code,{children:`insufficient_user_quota`}),`, но и:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`даже если запрос пройдет, `,_jsx(_components.strong,{children:`фактическая стоимость будет высокой`}),` (тарификация идет по реальным token);`]}),`\n`,_jsxs(_components.li,{children:[`если загрузить слишком много нерелевантного контента, модель может `,_jsx(_components.strong,{children:`вернуть посредственный результат`}),` — деньги потрачены, а результат слабый.`]}),`\n`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`как-исправить-и-избежать-этого`,children:`Как исправить и избежать этого`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Сократите входные данные`,icon:`scissors`,children:_jsxs(_components.p,{children:[`Отправляйте только `,_jsx(_components.strong,{children:`релевантный`}),` код/документацию — не загружайте весь репозиторий или длинный документ целиком. Это самый эффективный способ исправить проблему.`]})}),_jsx(Card,{title:`Установите max_tokens`,icon:`ruler`,children:_jsxs(_components.p,{children:[`Явно ограничьте длину вывода, чтобы снизить «оценочное количество output tokens» и, соответственно, предварительное списание. См. `,_jsx(_components.a,{href:`/ru/faq/max-tokens`,children:`руководство по max_tokens`}),`.`]})}),_jsx(Card,{title:`Пополните баланс`,icon:`credit-card`,children:_jsxs(_components.p,{children:[`Если вам действительно нужен большой входной объем, просто убедитесь, что баланс > предварительное списание. См. `,_jsx(_components.a,{href:`/ru/faq/payment-methods`,children:`способы оплаты`}),`.`]})}),_jsx(Card,{title:`Сначала протестируйте на небольшой модели`,icon:`flask-conical`,children:_jsx(_components.p,{children:`Проверьте, что ваш входной объем разумен для дешевой модели, а затем переключитесь на более дорогую — не допускайте «сжигания больше, чем вы можете себе позволить».`})})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Будьте осторожны с большими входными данными`}),`: модели с большим контекстным окном (например, у `,_jsx(_components.code,{children:`gpt-5.5`}),` 1.05M tokens) могут удерживать очень много, но «могут удерживать» не означает «должны удерживать». Запихивать в них весь репозиторий часто и дорого, и посредственно — сначала подумайте, какой контекст вам действительно нужен.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`вопросы-и-ответы`,children:`Вопросы и ответы`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Действительно ли предварительное списание спишет такую сумму?`,id:`deystvitelno-li-predvaritelnoe-spisanie-spishet-takuyu-summu`,children:_jsxs(_components.p,{children:[`Нет. Предварительное списание — это лишь `,_jsx(_components.strong,{children:`временное удержание перед запросом`}),`; окончательное списание определяется `,_jsx(_components.strong,{children:`фактическим использованием token`}),` после завершения запроса, а излишне удержанная часть возвращается. `,_jsx(_components.code,{children:`preConsumedQuota`}),`, который вы видите, — это оценка «резерв на худший случай», а не реальный счет.`]})}),_jsx(Accordion,{title:`Будет ли с меня списание, если запрос завершится ошибкой?`,id:`budet-lis-menya-spisanie-esli-zapros-zavershitsya-oshibkoy`,children:_jsxs(_components.p,{children:[`Обычно нет. Ошибка `,_jsx(_components.code,{children:`insufficient_user_quota`}),` блокируется `,_jsx(_components.strong,{children:`до выполнения`}),`, поэтому модель фактически не вызывается, реальных затрат не возникает, а удержанная квота освобождается.`]})}),_jsx(Accordion,{title:`На балансе явно достаточно средств — почему возникает ошибка квоты?`,id:`na-balanse-yavno-dostatochno-sredstv-pochemu-voznikaet-oshibka-kvoty`,children:_jsxs(_components.p,{children:[`В этой ошибке сравнивается `,_jsx(_components.strong,{children:`предварительное списание`}),` с вашим балансом, а не «фактическая стоимость» с балансом. Слишком большой ввод делает оценку предварительного списания намного выше вашего баланса, поэтому запрос отклоняется. Сначала сократите ввод или задайте `,_jsx(_components.code,{children:`max_tokens`}),`, чтобы снизить оценку вывода, и пополните баланс, если этого все еще недостаточно.`]})}),_jsx(Accordion,{title:`Всегда ли модели с большим контекстным окном дороже?`,id:`vsegda-li-modelis-bolshim-kontekstnym-oknom-dorozhe`,children:_jsxs(_components.p,{children:[`Базовая цена модели задается самой моделью — `,_jsx(_components.strong,{children:`большее окно ≠ более высокая цена за единицу`}),`. Но большее окно означает, что вы `,_jsx(_components.em,{children:`можете`}),` передать больше ввода, и когда вы действительно заполняете его, количество input tokens резко растет, и как предварительное списание, так и фактическая стоимость становятся высокими. Дорого стоит не само окно, а «сколько вы в него помещаете».`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`связанные-документы`,children:`Связанные документы`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Почему запрос не выполняется, несмотря на наличие баланса?`,icon:`credit-card`,href:`/ru/faq/balance-insufficient`,children:_jsx(_components.p,{children:`Полное руководство по устранению проблем и исправлению недостаточного баланса.`})}),_jsx(Card,{title:`Как задать max_tokens?`,icon:`ruler`,href:`/ru/faq/max-tokens`,children:_jsx(_components.p,{children:`Управление длиной вывода, которая влияет на предварительную оценку списания.`})}),_jsx(Card,{title:`Узнайте фактическую стоимость видеозадачи по task_id`,icon:`receipt`,href:`/ru/faq/seedance-task-cost-lookup`,children:_jsx(_components.p,{children:`Взаимосвязь записей о предварительном списании и окончательном расчёте с квотой задачи.`})}),_jsx(Card,{title:`Режимы тарификации token`,icon:`coins`,href:`/ru/faq/token-billing-modes`,children:_jsx(_components.p,{children:`Узнайте, как работает расчёт на основе использования.`})}),_jsx(Card,{title:`Способы оплаты`,icon:`credit-card`,href:`/ru/faq/payment-methods`,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":"Что такое механизм предварительного списания для API-вызовов?","description":"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.","icon":"calculator","href":"/ru/faq/pre-deduction-quota"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Краткий ответ","slug":"краткий-ответ","depth":2,"children":[]},{"title":"Как работает предварительное списание","slug":"как-работает-предварительное-списание","depth":2,"children":[]},{"title":"Чтение ошибки insufficient_user_quota","slug":"чтение-ошибки-insufficient_user_quota","depth":2,"children":[]},{"title":"Почему «у меня есть баланс, но это не запускается»","slug":"почему-«у-меня-есть-баланс-но-это-не-запускается»","depth":2,"children":[]},{"title":"Как исправить и избежать этого","slug":"как-исправить-и-избежать-этого","depth":2,"children":[]},{"title":"Вопросы и ответы","slug":"вопросы-и-ответы","depth":2,"children":[]},{"title":"Связанные документы","slug":"связанные-документы","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"apiyillc","siteName":"API易文档中心","title":"Что такое механизм предварительного списания для API-вызовов? - API易文档中心","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh":{"href":"/faq/pre-deduction-quota","matchLevel":1},"en":{"href":"/en/faq/pre-deduction-quota","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/faq/pre-deduction-quota","matchLevel":1},"ja":{"href":"/ja/faq/pre-deduction-quota","matchLevel":1},"ko":{"href":"/ko/faq/pre-deduction-quota","matchLevel":1},"ru":{"href":"/ru/faq/pre-deduction-quota","matchLevel":0}}},"lastModified":"2026-09-15T08:29:38.712Z","originalFileLocation":"ru/faq/pre-deduction-quota.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=\"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\">\u003cmeta data-mint-head name=\"application-name\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Что такое механизм предварительного списания для API-вызовов? - API易文档中心\">\u003cmeta data-mint-head property=\"og:description\" content=\"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ru/faq/pre-deduction-quota\">\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%9E%D0%BF%D0%BB%D0%B0%D1%82%D0%B0+%D0%B8+%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C\u0026amp;title=%D0%A7%D1%82%D0%BE+%D1%82%D0%B0%D0%BA%D0%BE%D0%B5+%D0%BC%D0%B5%D1%85%D0%B0%D0%BD%D0%B8%D0%B7%D0%BC+%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE+%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D1%8F+%D0%B4%D0%BB%D1%8F+API-%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%BE%D0%B2%3F\u0026amp;description=%D0%9A%D0%B0%D0%BA+%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%D0%B5%D1%82+%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5+%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5+%28%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE+%D0%BF%D0%BE%D1%82%D1%80%D0%B5%D0%B1%D0%BB%D1%91%D0%BD%D0%BD%D0%B0%D1%8F+%D0%BA%D0%B2%D0%BE%D1%82%D0%B0%29+%D0%B2+APIYI%3A+%D0%BF%D0%B5%D1%80%D0%B5%D0%B4+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%BC+%D0%BE%D0%BD%D0%BE+%D0%BE%D1%86%D0%B5%D0%BD%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D1%83%D0%B4%D0%B5%D1%80%D0%B6%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BD%D0%B0+%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B5+%D1%86%D0%B5%D0%BD%D1%8B+%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D0%B8+%D0%B8+%D0%B2%D1%85%D0%BE%D0%B4%D0%BD%D1%8B%D1%85+%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=d772b729a269d68c051f106607acea26b2edc7b21d1f89c40d091918ff4531a3\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Что такое механизм предварительного списания для API-вызовов? - API易文档中心\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=%D0%9E%D0%BF%D0%BB%D0%B0%D1%82%D0%B0+%D0%B8+%D0%B1%D0%B5%D0%B7%D0%BE%D0%BF%D0%B0%D1%81%D0%BD%D0%BE%D1%81%D1%82%D1%8C\u0026amp;title=%D0%A7%D1%82%D0%BE+%D1%82%D0%B0%D0%BA%D0%BE%D0%B5+%D0%BC%D0%B5%D1%85%D0%B0%D0%BD%D0%B8%D0%B7%D0%BC+%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B3%D0%BE+%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D1%8F+%D0%B4%D0%BB%D1%8F+API-%D0%B2%D1%8B%D0%B7%D0%BE%D0%B2%D0%BE%D0%B2%3F\u0026amp;description=%D0%9A%D0%B0%D0%BA+%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%D0%B5%D1%82+%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5+%D1%81%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5+%28%D0%BF%D1%80%D0%B5%D0%B4%D0%B2%D0%B0%D1%80%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE+%D0%BF%D0%BE%D1%82%D1%80%D0%B5%D0%B1%D0%BB%D1%91%D0%BD%D0%BD%D0%B0%D1%8F+%D0%BA%D0%B2%D0%BE%D1%82%D0%B0%29+%D0%B2+APIYI%3A+%D0%BF%D0%B5%D1%80%D0%B5%D0%B4+%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%BC+%D0%BE%D0%BD%D0%BE+%D0%BE%D1%86%D0%B5%D0%BD%D0%B8%D0%B2%D0%B0%D0%B5%D1%82+%D1%83%D0%B4%D0%B5%D1%80%D0%B6%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BD%D0%B0+%D0%BE%D1%81%D0%BD%D0%BE%D0%B2%D0%B5+%D1%86%D0%B5%D0%BD%D1%8B+%D0%BC%D0%BE%D0%B4%D0%B5%D0%BB%D0%B8+%D0%B8+%D0%B2%D1%85%D0%BE%D0%B4%D0%BD%D1%8B%D1%85+%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=d772b729a269d68c051f106607acea26b2edc7b21d1f89c40d091918ff4531a3\">\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/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ru/faq/pre-deduction-quota.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apiyi.com/ru/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.apiyi.com/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apiyi.com/en/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.apiyi.com/zh-Hant/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apiyi.com/ja/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apiyi.com/ko/faq/pre-deduction-quota\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apiyi.com/faq/pre-deduction-quota\">\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/faq/pre-deduction-quota#webpage\",\"url\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota\",\"name\":\"Что такое механизм предварительного списания для API-вызовов?\",\"description\":\"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\",\"dateModified\":\"2026-09-15T08:29:38.712Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Оплата и безопасность\",\"item\":\"https://docs.apiyi.com/ru/faq/model-name-suffix-c\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Что такое механизм предварительного списания для API-вызовов?\",\"item\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota#article\",\"headline\":\"Что такое механизм предварительного списания для API-вызовов?\",\"name\":\"Что такое механизм предварительного списания для API-вызовов?\",\"description\":\"Как работает предварительное списание (предварительно потреблённая квота) в APIYI: перед запросом оно оценивает удержание на основе цены модели и входных данных, а затем производит окончательный расчёт по фактическому использованию — а также как читать ошибку insufficient_user_quota.\",\"url\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ru/faq/pre-deduction-quota#webpage\"},\"dateModified\":\"2026-09-15T08:29:38.712Z\",\"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":"/faq/pre-deduction-quota"}]},{"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/faq/pre-deduction-quota"}]},{"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/faq/pre-deduction-quota"}]},{"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/faq/pre-deduction-quota"}]},{"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/faq/pre-deduction-quota"}]},{"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","pages":[{"title":"Главная","href":"/ru"}]},{"tab":"Сценарии использования","icon":"layout-grid","pages":[{"title":"Сценарии использования","href":"/ru/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","groups":[{"group":"Обзор","pages":[{"title":"Обзор часто задаваемых вопросов","sidebarTitle":"Часто задаваемые вопросы","icon":"circle-question-mark","href":"/ru/faq"}]},{"group":"Возможности сайта","icon":"compass","pages":[{"title":"Tokens \u0026 Группы","icon":"key","href":"/ru/faq/token-and-groups"},{"title":"Что такое группа? Объяснение User Group и Token Group","icon":"layers","href":"/ru/faq/groups-explained"},{"title":"Чем отличаются группы CodexReverse, ClaudeCode и по умолчанию?","icon":"code","href":"/ru/faq/codex-claudecode-default-groups"},{"title":"Есть ли интеграция одним кликом?","icon":"plug","href":"/ru/faq/one-click-integration"}]},{"group":"Tokens и журналы","icon":"key","pages":[{"title":"В журнале указано, что вызов завершился и был тарифицирован, но мой клиент так и не получил ответ — как это отладить?","icon":"stethoscope","href":"/ru/faq/log-duration-vs-client-wait"},{"title":"Почему я не могу использовать некоторые модели?","icon":"lock","href":"/ru/faq/model-availability"},{"title":"Что такое персональный token доступа и как заменить системный token?","icon":"key-round","href":"/ru/faq/personal-access-token"},{"title":"Как создать KEY?","icon":"key","href":"/ru/faq/token-management"},{"title":"Нужно ли задавать доступные модели для token?","icon":"list-check","href":"/ru/faq/token-model-whitelist"},{"title":"Как безопасно управлять API-ключами?","icon":"shield-check","href":"/ru/faq/key-security-management"},{"title":"В чем разница между режимами тарификации token?","icon":"calculator","href":"/ru/faq/token-billing-modes"},{"title":"Как посмотреть мои записи вызовов?","icon":"file-text","href":"/ru/faq/call-logs"},{"title":"Где найти идентификатор запроса?","icon":"search","href":"/ru/faq/request-id-troubleshooting"},{"title":"Как читать суммы тарификации в логах?","icon":"receipt","href":"/ru/faq/log-billing-explained"},{"title":"Как долго хранятся журналы вызовов и когда они очищаются?","icon":"clock","href":"/ru/faq/log-retention-policy"},{"title":"Что нужно знать о настройках часового пояса в логах и экспорте данных?","icon":"globe","href":"/ru/faq/log-timezone-and-export"},{"title":"Могу ли я просматривать подробные логи в backend для устранения неполадок?","icon":"toggle-right","href":"/ru/faq/user-logs-control"},{"title":"Как расследовать неожиданное использование API Key?","icon":"key","href":"/ru/faq/troubleshoot-key-usage"}]},{"group":"Корпоративные услуги","icon":"building-2","pages":[{"title":"Что такое Enterprise-группа? Когда следует ее использовать?","icon":"building-2","href":"/ru/faq/enterprise-group-vertex-fallback"},{"title":"Есть ли более быстрый или корпоративный маршрут для генерации изображений?","icon":"route","href":"/ru/faq/image-generation-fast-enterprise-route"},{"title":"Надёжен ли корпоративный сервис APIYI? Подлинны ли модели?","icon":"badge-check","href":"/ru/faq/enterprise-trust"},{"title":"В чем разница между корпоративными и индивидуальными пользователями?","icon":"building-2","href":"/ru/faq/enterprise-vs-individual"},{"title":"Как корпоративным клиентам пополнять баланс?","icon":"landmark","href":"/ru/faq/enterprise-recharge"},{"title":"Как университетским клиентам оформить возмещение без лишних хлопот?","icon":"graduation-cap","href":"/ru/faq/university-reimbursement"},{"title":"Предлагает ли APIYI SLA-гарантии?","icon":"shield-check","href":"/ru/faq/sla-guarantee"},{"title":"Нужна ли мини-программе Agent регистрация алгоритма?","icon":"file-check","href":"/ru/faq/agent-miniapp-algorithm-filing"},{"title":"Как обеспечить соответствие требованиям для продукта, ориентированного на Китай, при использовании зарубежных моделей?","icon":"scale","href":"/ru/faq/overseas-model-compliance"}]},{"group":"Оплата и безопасность","icon":"shield","pages":[{"title":"Что означает суффикс -c в названиях model?","icon":"tag","href":"/ru/faq/model-name-suffix-c"},{"title":"Цены совпадают с официальными тарифами — зачем покупать у APIYI?","icon":"badge-percent","href":"/ru/faq/official-pricing-advantages"},{"title":"Почему APIYI может стоить ниже официальных тарифов?","icon":"trending-down","href":"/ru/faq/why-cheaper-than-official"},{"title":"Что означает модельный 'множитель'?","icon":"calculator","href":"/ru/faq/model-multiplier"},{"title":"Сколько вычислительных ресурсов дают 100 RMB?","description":"APIYI предоставляет только сервисы моделей и соответствующие цены. Пополнение в RMB выполняется по фиксированному курсу 1 USD = 7 RMB; коэффициент пересчёта в вычислительные ресурсы определяется вашей собственной платформой.","icon":"calculator","href":"/ru/faq/rmb-to-computing-power"},{"title":"Что такое механизм предварительного списания для API-вызовов?","icon":"calculator","href":"/ru/faq/pre-deduction-quota"},{"title":"Поддерживает ли APIYI тарификацию кэша?","description":"Да. Claude, OpenAI, Gemini, DeepSeek, Qwen, Grok и другие основные каналы все поддерживают тарификацию кэша — поля попадания в кэш возвращаются без изменений, а счета выставляются по официальным скидочным ставкам","icon":"database","href":"/ru/faq/cache-billing"},{"title":"Какие способы оплаты поддерживает APIYI?","icon":"credit-card","href":"/ru/faq/payment-methods"},{"title":"Какие акции по пополнению доступны?","icon":"gift","href":"/ru/faq/recharge-promotions"},{"title":"Истекает ли срок действия моего баланса APIYI? Каков срок действия?","icon":"hourglass","href":"/ru/faq/balance-validity-period"},{"title":"Как настроить оповещения о балансе?","icon":"bell","href":"/ru/faq/balance-alerts"},{"title":"Почему я не могу отправлять запросы при оставшемся балансе?","icon":"credit-card","href":"/ru/faq/balance-insufficient"},{"title":"Что делать, если сумма счета меньше $100?","icon":"receipt","href":"/ru/faq/invoice-minimum-amount"},{"title":"Я указал неверные данные в счёте. Можно ли перевыпустить счёт?","icon":"receipt","href":"/ru/faq/invoice-reissue"},{"title":"Какова политика возврата средств APIYI?","icon":"receipt","href":"/ru/faq/refund-policy"},{"title":"Как подать заявку на партнерство агента? Могу ли я получать возврат, приглашая друзей?","icon":"users","href":"/ru/faq/referral-program"},{"title":"Как обеспечивается безопасность контента и соблюдение требований?","icon":"shield-check","href":"/ru/faq/content-safety"},{"title":"Как APIYI обеспечивает безопасность данных?","icon":"shield","href":"/ru/faq/data-security"}]},{"group":"Сеть и подключение","icon":"wifi","pages":[{"title":"Как избежать тайм-аутов API?","icon":"timer","href":"/ru/faq/timeout-configuration"},{"title":"Нужен ли мне прокси для использования API?","icon":"wifi","href":"/ru/faq/network-proxy"},{"title":"Python выдаёт SSLEOFError, но curl работает?","icon":"shield-alert","href":"/ru/faq/openssl-pq-handshake-eof"},{"title":"Где находятся серверы APIYI? Какой сервер мне выбрать?","icon":"server","href":"/ru/faq/server-location"},{"title":"Медленное скачивание изображений/видео из CDN или таймаут — что делать?","icon":"gauge","href":"/ru/faq/cdn-download-slow"},{"title":"Является ли http тем же самым, что и HTTP/1.1?","icon":"network","href":"/ru/faq/http-vs-http11"},{"title":"Как снизить задержку API генерации изображений?","icon":"gauge","href":"/ru/faq/image-api-network-latency-optimization"},{"title":"Веб-сайт или API возвращает 502 — что мне делать?","icon":"refresh-cw","href":"/ru/faq/website-502-error"},{"title":"Скрипт получает 502, но в журналах вызовов ничего нет?","icon":"unplug","href":"/ru/faq/proxy-empty-502"},{"title":"Запросы на генерацию изображений обрываются примерно через 90 секунд при работе через прокси?","icon":"unplug","href":"/ru/faq/proxy-idle-timeout-disconnect"},{"title":"Запрос на генерацию изображения зависает без результата, но в журнале указана ошибка записи?","icon":"hourglass","href":"/ru/faq/image-direct-large-response-stall"}]},{"group":"Аккаунт и вход","icon":"user","pages":[{"title":"Как обеспечить безопасность аккаунта? Зачем привязывать 2FA и Passkey?","icon":"shield-check","href":"/ru/faq/account-security-2fa-passkey"},{"title":"Какие почтовые провайдеры поддерживает APIYI для регистрации?","icon":"mail","href":"/ru/faq/email-registration"},{"title":"Как войти с помощью Passkey?","icon":"fingerprint-pattern","href":"/ru/faq/passkey-login"},{"title":"Вход через GitHub показывает «Учетная запись уже привязана»?","icon":"github","href":"/ru/faq/github-bindng-bindng-error"},{"title":"Что делать, если вы забыли пароль?","icon":"lock","href":"/ru/faq/forgot-password"},{"title":"Почему мой API Key недействителен?","icon":"key","href":"/ru/faq/invalid-api-key"},{"title":"Как удалить учетную запись?","icon":"trash","href":"/ru/faq/account-deletion"}]}]},{"tab":"Акции","icon":"gift","pages":[{"title":"Акции","href":"/ru/faq/recharge-promotions"}]},{"tab":"Цены на модели","icon":"circle-dollar-sign","pages":[{"title":"Цены на модели","href":"/ru/models"}]}]}]},"title":"Что такое механизм предварительного списания для API-вызовов? - API易文档中心","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["10e4515597"],"chunks":["BannerMarkdown-cfwQA_n9.js","dist-2LoAhjKH.js","lib--scc4DXi.js","lib-B8HbPgcC.js","clsx-DZLdJUrt.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}