> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Обзор FAQ
> Полный индекс часто задаваемых вопросов APIYI: начало работы, вызовы моделей, tokens и журналы, тарификация, корпоративные услуги и вход в аккаунт — просмотр по теме или по симптомам.
Здесь проиндексированы все статьи FAQ APIYI. Вы впервые знакомитесь с APIYI? Начните с **Начало работы** и **Частые вопросы**. Уже интегрировали и столкнулись с конкретной ошибкой? Перейдите к **Устранение неполадок по симптомам**. Хотите ознакомиться со всем материалом? См. **Просмотр по темам** ниже.
## 🚀 Начало работы в 3 шага
Поддерживаются Gmail, Outlook, Foxmail и университетские email-адреса, либо войдите через GitHub
Возьмите token по умолчанию из консоли или создайте отдельный KEY и выберите его группу
Используйте `/v1` для формата OpenAI, корневой домен для Claude, `/v1beta` для Gemini
## 🔥 Популярные вопросы
Получение стандартного token и создание нового KEY, шаг за шагом
Что из `/v1`, корневого домена или `/v1beta` применяется к каким моделям
Выбор модели по сценарию использования, стоимости и скорости
В девяти случаях из десяти не совпадают Base URL и KEY — сначала проверьте это
Механизм предварительного списания и завышенные значения max\_tokens
Множитель — это единица RMB; примените фиксированный курс, чтобы получить эквивалент в USD
Бонусы для первого пополнения, многоуровневые бонусы и корпоративные политики
Почему одна и та же модель кажется умнее на официальном сайте, чем через API
***
## 🔧 Устранение неполадок по симптомам
Найдите строку, которая соответствует тому, что вы действительно видите. Один симптом часто охватывает несколько тем, поэтому эта таблица заново группирует статьи по устранению неполадок по наблюдаемому поведению.
| Что вы видите | Вероятная причина | Где смотреть |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Неверный API Key / 401 | Base URL и KEY не совпадают, либо KEY введен с ошибкой | [Недействительный API Key](/ru/faq/invalid-api-key) · [Настройка Base URL](/ru/faq/base-url-config) |
| Баланс еще есть, но запросы не проходят | Механизм предварительного списания, или слишком большое значение max\_tokens | [Недостаточный баланс](/ru/faq/balance-insufficient) · [Предварительное списание](/ru/faq/pre-deduction-quota) |
| Запрос истекает по тайм-ауту или обрывается на середине потоковой передачи | Слишком короткий тайм-аут клиента; модели с рассуждением работают медленно | [Как избежать тайм-аутов API](/ru/faq/timeout-configuration) |
| Ошибки 429 из-за параллельных запросов | Достигнута квота на параллельные запросы | [Лимиты параллельных запросов API](/ru/faq/api-concurrency) |
| Вывод обрывается на середине предложения | max\_tokens не задан или слишком мал | [Что такое max\_tokens](/ru/faq/max-tokens) |
| Определенная модель не запускается | Заблокировано разрешение учетной записи, или whitelist token-моделей | [Почему я не могу использовать некоторые модели](/ru/faq/model-availability) · [Whitelist token-моделей](/ru/faq/token-model-whitelist) |
| Генерация изображений не удается / возвращает пустой результат | Сработала система обеспечения безопасности контента Google | [Сбои Nano Banana](/ru/faq/nano-banana-image-failure) |
| Вывод сильно отличается от референсного изображения | Референсные изображения нужно загружать как base64 | [Изображение отличается от референса](/ru/faq/image-result-differs-from-reference) |
| На изображении с белым фоном видны черные точки | Известное поведение на маршруте AI Studio | [Артефакты белого фона](/ru/faq/white-background-image-artifacts) |
| Нужен опрос результатов изображений по task ID | Генерация изображений поддерживается только синхронно | [Есть ли асинхронный API для изображений](/ru/faq/image-async-api) |
| Модель утверждает, что она от другого поставщика / не может назвать свою версию | Самоосведомленность модели ненадежна | [Claude утверждает, что это Qwen](/ru/faq/claude-identity-confusion) · [Модели не знают свою версию](/ru/faq/model-version-identity) |
| Веб-приложение умное, API глупый | Веб-приложение поставляет system prompts и инструменты; API — это голая модель | [Веб-приложение vs API](/ru/faq/webapp-vs-api-difference) |
| На вашем KEY замечены незнакомые вызовы | KEY мог быть скомпрометирован — отследите его и отключите | [Проверка неожиданного использования KEY](/ru/faq/troubleshoot-key-usage) · [Безопасное управление ключами](/ru/faq/key-security-management) |
| Тарификация не сходится | Тарификация по использованию и по вызовам читается по-разному | [Чтение тарификации в логах](/ru/faq/log-billing-explained) · [Множитель модели](/ru/faq/model-multiplier) |
| Загрузка изображений или видео идет медленно | Маршрутизация через зарубежный CDN на определенных серверах | [Загрузки через CDN медленные](/ru/faq/cdn-download-slow) |
| Нужен ли мне proxy? | Прямое подключение работает; proxy не требуется | [Нужен ли мне proxy](/ru/faq/network-proxy) |
| При входе через GitHub появляется сообщение 'Account already bound' | Этот аккаунт GitHub привязан к другому email | [Ошибка привязки GitHub](/ru/faq/github-bindng-bindng-error) |
| Забыли пароль | Сбросьте его по email или обратитесь в поддержку за помощью | [Забыли пароль](/ru/faq/forgot-password) |
***
## 📚 Просмотр по темам
### 🧭 Возможности сайта (3)
| Вопрос | В одной строке |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| [Tokens и группы](/ru/faq/token-and-groups) | Как создать ключ и выбрать группу |
| [Что такое группа? Объяснение: группа пользователя vs группа token](/ru/faq/groups-explained) | Применяется именно группа, выбранная в token |
| [Почему APIYI не предлагает интеграцию в один клик?](/ru/faq/one-click-integration) | Интеграция отличается для каждой модели; вместо этого используйте ИИ-ассистента |
### ⚙️ Models & API (15)
| Вопрос | В одной строке |
| -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| [Do Google Models Run on AI Studio or Vertex?](/ru/faq/google-upstream-aistudio-vertex) | Группы по умолчанию используют официальный маршрут AI Studio |
| [Why Does a White-Background Image Show Black Spots, Dirty Patches, or Blurry Color Blocks?](/ru/faq/white-background-image-artifacts) | Укажите светлый фон вместо чисто белого |
| [How to Choose the Right AI Model?](/ru/faq/model-selection-guide) | Выбирайте по сценарию использования, стоимости и скорости |
| [Why can't I use some models?](/ru/faq/model-availability) | Для некоторых моделей сначала нужно разблокировать разрешение |
| [Why do official web apps and the API give different results?](/ru/faq/webapp-vs-api-difference) | Веб-приложение добавляет system prompts; API — это чистая модель |
| [Why Don't AI Models Know Their Own Version?](/ru/faq/model-version-identity) | Самоописание модели ненадежно |
| [Why Does Claude Claim to Be Qwen or DeepSeek?](/ru/faq/claude-identity-confusion) | Галлюцинация идентичности, а не подмененная модель |
| [What does the -c suffix in model names mean?](/ru/faq/model-name-suffix-c) | Помечает другой маршрут с другой тарификацией |
| [How to Configure Base URL? Differences Between /v1, Root Domain, and /v1beta](/ru/faq/base-url-config) | По одному варианту для OpenAI, Claude и Gemini |
| [How do I avoid API timeouts?](/ru/faq/timeout-configuration) | Увеличьте timeout клиента; reasoning-модели работают медленно |
| [What Are the API Concurrency Limits?](/ru/faq/api-concurrency) | Лимиты зависят от типа модели и могут быть увеличены |
| [What is max\_tokens? What Happens If Not Set?](/ru/faq/max-tokens) | Ограничивает длину вывода; если не задан, используется значение по умолчанию |
| [Common Reasons for Nano Banana Image Generation Failures](/ru/faq/nano-banana-image-failure) | Обычно это срабатывание системы Google content safety |
| [Why Does the Generated Image Differ Greatly from the Reference?](/ru/faq/image-result-differs-from-reference) | Референсные изображения должны быть закодированы в base64 |
| [Is There an Async Image API? Can I Query Results by Task ID?](/ru/faq/image-async-api) | Только синхронный; поиска по Task ID нет |
### 🔑 token и журналы (9)
| Вопрос | В одну строку |
| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [Как создать KEY?](/ru/faq/token-management) | Получите token по умолчанию или создайте новый в консоли |
| [Нужно ли задавать доступные модели для token?](/ru/faq/token-model-whitelist) | Необязательно, но рекомендуется при изоляции проектов |
| [Как безопасно управлять API keys?](/ru/faq/key-security-management) | Белые списки IP, белые списки моделей и ежедневные привычки |
| [В чем разница между режимами тарификации token?](/ru/faq/token-billing-modes) | Пять режимов тарификации и когда подходит каждый |
| [Как посмотреть мои записи вызовов?](/ru/faq/call-logs) | Детали вызовов и тарификации на странице журнала в консоли |
| [Как читать суммы тарификации в журналах?](/ru/faq/log-billing-explained) | Оплата по использованию или по вызову и расчет стоимости по использованию |
| [Как долго хранятся журналы вызовов и когда они очищаются?](/ru/faq/log-retention-policy) | Текущий месяц и два предыдущих; очищаются 5-го числа |
| [Могу ли я просматривать подробные журналы в backend для устранения неполадок?](/ru/faq/user-logs-control) | Администраторы могут временно включить подробное журналирование |
| [Как расследовать неожиданное использование API Key?](/ru/faq/troubleshoot-key-usage) | Отслеживайте реальные IP-адреса в журналах и отключите KEY |
### 🏢 Корпоративные сервисы (7)
| Вопрос | В двух словах |
| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [Что такое корпоративная группа? Когда ее следует использовать?](/ru/faq/enterprise-group-vertex-fallback) | Группа для конкретной модели с более стабильной поставкой и более высоким коэффициентом тарифа |
| [Надежен ли корпоративный сервис APIYI? Подлинны ли модели?](/ru/faq/enterprise-trust) | Прозрачный официальный релей — без перенаправления или подмены модели |
| [В чем разница между корпоративными и индивидуальными пользователями?](/ru/faq/enterprise-vs-individual) | Тип аккаунта одинаковый; различия только в поддержке и тарификации |
| [Как корпоративным клиентам пополнять баланс?](/ru/faq/enterprise-recharge) | Предпочтителен банковский перевод; доступны счета-фактуры с НДС |
| [Как университетским клиентам без лишних хлопот оформить возмещение?](/ru/faq/university-reimbursement) | Предоставляются счета, списки покупок и документы с печатью |
| [Предоставляет ли APIYI гарантии SLA?](/ru/faq/sla-guarantee) | Да, включая компенсацию за аномалии тарификации и пополнение кредита |
| [Требуется ли алгоритмическая регистрация для Mini-Program Agent?](/ru/faq/agent-miniapp-algorithm-filing) | Обычно да; здесь описан общий процесс |
### 💰 Тарификация и безопасность (14)
| Вопрос | В одной строке |
| ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| [Цены совпадают с официальными тарифами — зачем покупать у APIYI?](/ru/faq/official-pricing-advantages) | Та же цена плюс бонусы на пополнение, суммируемые с групповыми скидками |
| [Как APIYI может быть дешевле официальных тарифов?](/ru/faq/why-cheaper-than-official) | Оптовые закупки и распределение по вендорам, а не ухудшенные модели |
| [Что означает «Множитель» модели?](/ru/faq/model-multiplier) | Единица в RMB; для эквивалента в USD применяется фиксированный курс |
| [Сколько вычислительной мощности дает 100 RMB?](/ru/faq/rmb-to-computing-power) | Коэффициент конверсии определяет ваша собственная система |
| [Поддерживает ли APIYI тарификацию кэша?](/ru/faq/cache-billing) | Все основные маршруты это поддерживают; процент попаданий зависит от вендора |
| [Что представляет собой механизм предварительного списания для вызовов API?](/ru/faq/pre-deduction-quota) | Предварительная оценка с последующим расчетом по фактическому использованию |
| [Почему я не могу выполнять запросы при наличии остатка баланса?](/ru/faq/balance-insufficient) | Проверка предварительного списания или слишком высокое значение max\_tokens |
| [Как настроить уведомления о балансе?](/ru/faq/balance-alerts) | По email, через боты в группе или через API уведомлений о балансе |
| [Какие способы оплаты поддерживает APIYI?](/ru/faq/payment-methods) | WeChat, Alipay, USDT, Stripe, PayPal и другие |
| [Какие акции на пополнение доступны?](/ru/faq/recharge-promotions) | Бонусы при первом пополнении и по уровням, а также выставление счетов |
| [Как подать заявку на агентское партнерство? Можно ли получать реферальные бонусы за приглашение друзей?](/ru/faq/referral-program) | Реферальные бонусы включены по умолчанию; заявка не нужна |
| [Какова политика возврата средств APIYI?](/ru/faq/refund-policy) | Условия, процесс, комиссии и примечания к счетам |
| [Как обеспечиваются безопасность контента и соответствие требованиям?](/ru/faq/content-safety) | Механизмы модерации и обработка нарушений |
| [Как APIYI обеспечивает безопасность данных?](/ru/faq/data-security) | Зашифрованная передача, минимальное хранение, контроль доступа |
### 🌐 Сеть и подключение (3)
| Вопрос | В одной строке |
| ----------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| [Нужен ли мне прокси для использования API?](/ru/faq/network-proxy) | Прямое подключение работает; прокси или VPN не нужны |
| [Где находятся серверы APIYI? Какой сервер мне выбрать?](/ru/faq/server-location) | Расположение узлов, проверка задержки и советы по покупке |
| [Загрузка изображений/видео через CDN медленная — что делать?](/ru/faq/cdn-download-slow) | Диагностика зарубежной маршрутизации CDN на отдельных серверах |
### 👤 Аккаунт и вход (6)
| Question | В одной строке |
| -------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| [Какие почтовые сервисы APIYI поддерживает для регистрации?](/ru/faq/email-registration) | Gmail, Outlook, Foxmail и университетские адреса |
| [Как войти с помощью Passkey?](/ru/faq/passkey-login) | Однократно привяжите, затем используйте отпечаток пальца или разблокировку по лицу |
| [При входе через GitHub показывается «Account Already Bound»?](/ru/faq/github-bindng-bindng-error) | Этот аккаунт GitHub привязан к другому адресу email |
| [Что делать, если я забыл(а) пароль?](/ru/faq/forgot-password) | Сбросьте через email или обратитесь в поддержку за помощью |
| [Почему мой API Key недействителен?](/ru/faq/invalid-api-key) | Обычно причина в несоответствии Base URL и KEY |
| [Как удалить мой аккаунт?](/ru/faq/account-deletion) | Удаление в один клик; данные невозможно восстановить |
***
## 💬 Все еще не повезло?
Руководства по интеграции для Cherry Studio, Claude Code, Cursor и других
Таблица актуальных цен и страницы с подробностями для каждой модели
Ежедневные обновления о статусе моделей, изменениях поставок и инцидентах
Новые запуски моделей, изменения цен и обновления функций
Все еще не повезло? Свяжитесь с нами напрямую:
* 📧 **Email**: [support@apiyi.com](mailto:support@apiyi.com)
* 🌐 **Console**: [api.apiyi.com](https://api.apiyi.com)
* 💰 **Pricing**: [Страница цен](https://api.apiyi.com/account/pricing)
Если ваш вопрос не охвачен, отправьте его в поддержку — мы рассматриваем предложения и добавляем их в FAQ. Новые пользователи получают бесплатные пробные кредиты, так что вы можете проверить вашу интеграцию перед пополнением.