Обзор часто задаваемых вопросов

Найдите ответы на вопросы о платформе: аккаунтах APIYI, tokens, логах, тарификации и подключениях. Начните с разделов Начало работы и Популярные вопросы или воспользуйтесь разделом Устранение неполадок по симптомам. Информацию о моделях, параметрах API и клиентских tools см. в Руководствах по документации ниже.

🚀 Начало работы за 3 шага

Шаг 1: Зарегистрируйтесь

Поддерживаются адреса Gmail, Outlook, Foxmail и университетской почты. Также можно войти через GitHub

Шаг 2: Создайте ключ

Получите токен по умолчанию в консоли или создайте отдельный ключ и выберите для него группу

Шаг 3: Выполните API-вызов

Следуйте руководству по API, чтобы настроить клиент и отправить первый запрос

🔥 Популярные вопросы

Как создать ключ?

Как получить токен по умолчанию и создать новый ключ: пошаговая инструкция

Как защитить аккаунт?

Подключите 2FA или Passkey для дополнительной проверки помимо пароля

Почему мой API-ключ недействителен?

В девяти случаях из десяти базовый URL и ключ не совпадают — сначала проверьте это

Почему не удаётся отправлять запросы при наличии баланса?

Механизм предварительного списания и слишком большие значения max_tokens

Что означает коэффициент модели?

Коэффициент выражен в юанях: примените фиксированный курс, чтобы получить эквивалент в долларах США

Какие доступны акции на пополнение?

Бонусы при первом пополнении, бонусы по уровням и условия для корпоративных клиентов

🔧 Устранение неполадок по симптомам

Найдите строку, которая соответствует тому, что вы наблюдаете. Один симптом часто затрагивает несколько тем, поэтому в этой таблице статьи об устранении неполадок сгруппированы по наблюдаемому поведению.

Что вы наблюдаете	Вероятная причина	Подробнее
Недействительный API Key / 401	Базовый URL и KEY не соответствуют друг другу или KEY указан с ошибкой	Недействительный API Key
API для баланса, журналов или управления token возвращает 401 `ACCESS_TOKEN_LEGACY_RETIRED` или 403 `ACCESS_TOKEN_SCOPE_DENIED`	Устаревший системный token отключён или у персонального токена доступа нет необходимого разрешения	Персональные токены доступа
Баланс не исчерпан, но запросы завершаются с ошибкой	Механизм предварительного списания или слишком высокое значение max_tokens	Недостаточно средств на балансе · Предварительное списание
Время ожидания запроса истекает или соединение прерывается во время потоковой передачи	Слишком короткий тайм-аут клиента; модели рассуждения работают медленно	Как избежать превышения времени ожидания API
В журнале указаны успешное выполнение и тарификация, но клиент ничего не получил	Длительность в журнале заканчивается, когда шлюз завершает работу; задержка возникает дальше по цепочке или связана с сигналом завершения	Журнал показывает завершение, но ответ не получен
Сайт / API возвращает 502	Контейнер службы ненадолго автоматически перезапускается; работа восстанавливается примерно через 1 минуту	Что делать при ошибке 502
Скрипт время от времени получает 502 с пустым телом ответа, а в журналах ничего нет	Пустой ответ 502 формируется локальным прокси-программным обеспечением (Clash / v2rayN)	Пустой ответ 502, сформированный прокси
При вызовах генерации изображений через VPN соединение прерывается пакетами через 90–180 с, но запросы тарифицируются	Локальный прокси закрывает соединения, по которым слишком долго не передаются данные	Прокси отключает неактивные соединения
Прямое подключение: генерация изображений 4K зависает без ошибки, в журнале отображается `write_response_body_failed`	Ваш прямой канал не может передавать ответы размером в десятки МБ	Прямой канал прерывает передачу больших изображений
В Python возникает SSLEOFError, но curl работает	Посредники связи обрывают постквантовые рукопожатия OpenSSL 3.5+	Устранение ошибки SSLEOFError
Не удаётся запустить определённую модель	Для аккаунта заблокировано разрешение или в списке разрешённых моделей для token нет нужной модели	Почему некоторые модели недоступны · Список разрешённых моделей для token
Обнаружены неизвестные вызовы с использованием вашего KEY	Возможно, KEY утёк — выясните причину и отключите его	Проверка неожиданного использования KEY · Безопасное управление ключами
Сумма тарификации не сходится	Тарификация за использование и за вызов отображаются по-разному	Как читать данные о тарификации в журналах · Коэффициент модели
Изображения или видео загружаются медленно либо возникает Read timed out	Генерация завершилась успешно; проведите самопроверку и отправьте нам результаты	Медленная загрузка с CDN или превышение времени ожидания
Нужен ли мне прокси?	Прямое подключение работает, прокси не требуется	Нужен ли прокси
При входе через GitHub появляется сообщение «Аккаунт уже привязан»	Этот аккаунт GitHub привязан к другому адресу электронной почты	Ошибка привязки GitHub
Забыли пароль	Сбросьте пароль по электронной почте или обратитесь за помощью в службу поддержки	Забыли пароль

📖 Руководства по документации

Поведение моделей, параметры API и клиентские инструменты рассматриваются наряду с руководствами по интеграции.

Интеграция API

Базовый URL, входные файлы, ошибки запросов и параллельные запросы

Выбор модели

Возможности моделей, их выбор и ответы на распространённые вопросы об их поведении

Генерация изображений и видео

Следуйте руководству для каждой модели по генерации и устранению неполадок

Клиенты и агенты

Руководства по интеграции и устранению неполадок для клиентов и инструментов агентов

📚 Просмотр по темам

🧭 Возможности сайта (4)

Вопрос	Ответ в одной строке
Tokens и группы	Как создать KEY и выбрать группу
Что такое группа? Различия между группой пользователя и группой Token	Фактически применяется группа, выбранная для token
Чем отличаются группы Codex, Claude Code и Default?	Разные источники и протоколы; в production предпочтителен официальный релей Default
Почему APIYI не предлагает интеграцию в один клик?	Интеграция различается для каждой модели; используйте AI-ассистента

🔑 Tokens и журналы (14)

Вопрос	Ответ в одной строке
Как создать ключ?	Получите token по умолчанию или создайте новый в консоли
Нужно ли указывать доступные модели для tokens?	Необязательно, но рекомендуется для изоляции проектов
Как безопасно управлять ключами API?	Белые списки IP-адресов и моделей, а также ежедневные меры предосторожности
Что такое персональный токен доступа и как заменить системный token?	Новые учетные данные для API управления; срок действия системных tokens истекает 11-11
Чем отличаются режимы тарификации tokens?	Пять режимов тарификации и подходящие для каждого ситуации
Как просмотреть записи о вызовах?	Подробные сведения о вызовах и тарификации — на странице журнала в консоли
Где найти идентификатор запроса?	Проверьте заголовки или тело ответа в зависимости от типа API; не путайте его с идентификатором задачи
Как читать суммы тарификации в журналах?	Оплата за использование и за вызов, а также расчет стоимости по данным об использовании
Как долго хранятся журналы вызовов и когда они очищаются?	Текущий месяц и два предыдущих; очистка выполняется 5-го числа
Что нужно знать о настройках часового пояса журналов и экспорте данных?	Установите для учетной записи часовой пояс UTC+0; данные всегда экспортируются в UTC+0
Можно ли просматривать подробные журналы в серверной части для устранения неполадок?	Администраторы могут временно включить подробное журналирование
Как выяснить причину неожиданного использования ключа API?	Найдите реальные IP-адреса в журналах и отключите ключ
Почему некоторые модели недоступны?	Для некоторых моделей сначала нужно получить разрешение
В журнале указано, что вызов завершен и тарифицирован, но клиент не получил ответ — как устранить неполадку?	Эти два таймера измеряют разные интервалы; сначала измерьте разницу

🏢 Корпоративные услуги (9)

Вопрос	Краткий ответ
Что такое корпоративная группа? Когда её следует использовать?	Группа для конкретных моделей с более стабильным предложением и более высоким коэффициентом тарифа
Есть ли более быстрый или корпоративный маршрут для генерации изображений?	Экспресс-маршрута нет; время уходит на инференс самой модели
Заслуживает ли доверия корпоративный сервис APIYI? Подлинные ли модели?	Прозрачный официальный релей — без перенаправления и подмены моделей
В чём разница между корпоративными и индивидуальными пользователями?	Тип аккаунта одинаковый; различия заключаются в поддержке и тарификации
Как корпоративным клиентам выполнять пополнение?	Предпочтителен банковский перевод; доступны рамочные договоры и счета-фактуры с НДС
Как клиентам из университетов без проблем возмещать расходы?	Предоставляются счета, списки закупок и заверенные документы
Предоставляет ли APIYI гарантии SLA?	Да, включая компенсацию аномалий тарификации и пополнение кредитов
Нужна ли мини-программе Agent регистрация алгоритма?	Обычно да; здесь описан общий процесс
Как обеспечить соответствие требованиям для продукта, ориентированного на Китай и использующего зарубежные модели?	Лицензионные уровни, статус регистрации модели и модерация контента

💰 Тарификация и безопасность (18)

Вопрос	Ответ в одной строке
Цены соответствуют официальным тарифам — зачем покупать у APIYI?	Та же цена плюс бонусы за пополнение, которые суммируются со скидками для группы
Как APIYI удаётся устанавливать цены ниже официальных тарифов?	Закупки крупными партиями и дистрибуция поставщиков, а не модели с ухудшенными характеристиками
Что означает «множитель» модели?	Единица в RMB; для расчёта эквивалента в USD применяется фиксированный курс
Какую вычислительную мощность можно получить за 100 RMB?	Пополнение рассчитывается по фиксированному курсу 1 USD = 7 RMB; соотношение задаётся вашей системой
Поддерживает ли APIYI тарификацию кэша?	Все основные маршруты её поддерживают; доля попаданий в кэш зависит от поставщика
Как работает механизм предварительного списания за вызовы API?	Сначала списывается расчётная сумма, затем выполняется перерасчёт по фактическому использованию
Почему я не могу выполнять запросы, хотя на балансе ещё есть средства?	Проверка перед предварительным списанием или слишком высокое значение max_tokens
Как настроить уведомления о балансе?	По электронной почте, через ботов группы или API уведомлений о балансе
Истекает ли срок действия баланса APIYI? Каков срок действия?	365 дней; каждое новое пополнение обновляет срок действия всего баланса
Какие способы оплаты поддерживает APIYI?	WeChat, Alipay, USDT, Stripe, PayPal и другие
Что делать, если сумма в счёте меньше $100?	Объедините несколько небольших заказов, пока их сумма не достигнет $100
Я указал неверные данные для счёта. Можно ли его перевыпустить?	Отправьте исходные и правильные данные, чтобы аннулировать и перевыпустить счёт
Какие акции на пополнение доступны?	Бонусы за первое пополнение и бонусы по уровням, а также выставление счетов
Как подать заявку на партнёрство в качестве агента? Можно ли получать бонусы за приглашение друзей?	Реферальные бонусы включены по умолчанию; подавать заявку не нужно
Какова политика APIYI в отношении возвратов?	Условия, порядок оформления, комиссии и примечания по счетам
Как обеспечивается безопасность контента и соблюдение требований?	Механизмы модерации и обработка нарушений
Как APIYI обеспечивает безопасность данных?	Шифрование при передаче, минимальное хранение, контроль доступа
Что означает суффикс -c в названиях моделей?	Указывает на другой маршрут с отличающейся тарификацией

🌐 Сеть и подключение (11)

Вопрос	Краткий ответ
Нужен ли мне прокси для использования API?	Прямое подключение работает; прокси или VPN не нужны
В Python возникает SSLEOFError, а curl работает?	Постквантовые рукопожатия OpenSSL 3.5+ прерываются промежуточными сетевыми устройствами
Где находятся серверы APIYI? Какой сервер выбрать?	Расположение узлов, проверка задержки и советы по выбору
Загрузка изображений и видео с CDN идёт медленно или завершается по тайм-ауту — что делать?	Команды для самостоятельной проверки и сведения, которые нужно нам отправить
http — это то же самое, что HTTP/1.1?	Нет; большинству пользователей достаточно использовать https
Как уменьшить задержку API изображений?	Версия протокола клиента, повторное использование подключений и тайм-ауты
Сайт или API возвращает 502 — что делать?	Контейнер автоматически перезапускается; работа восстанавливается примерно за 1 минуту, плата не взимается, повторите запрос через 30 секунд
Скрипт получает 502, но в журналах вызовов ничего нет?	Пустой ответ 502 от локального прокси; настройте скрипт так, чтобы он обходил системный прокси
Вызовы для генерации изображений обрываются примерно через 90 секунд при использовании прокси?	Прокси закрывает неактивные подключения; направьте api.apiyi.com напрямую
Запрос на генерацию изображения зависает без результата, но в журнале указана ошибка записи?	Прямое подключение не поддерживает передачу больших изображений; направьте запросы на генерацию изображений через прокси
Как избежать тайм-аутов API?	Увеличьте тайм-аут клиента; модели с рассуждением работают медленно

👤 Аккаунт и вход (7)

Вопрос	Краткий ответ
Как защитить свой аккаунт? Привяжите 2FA и Passkey	Добавьте второй фактор: одной утечки пароля будет недостаточно для входа
Какие почтовые сервисы поддерживает APIYI для регистрации?	Gmail, Outlook, Foxmail и университетские адреса
Как войти с помощью Passkey?	Привяжите один раз, затем используйте отпечаток пальца или распознавание лица
При входе через GitHub появляется сообщение «Аккаунт уже привязан»?	Этот аккаунт GitHub привязан к другому адресу электронной почты
Что делать, если я забыл пароль?	Сбросьте пароль по почте или обратитесь в службу поддержки
Почему мой API-ключ недействителен?	Обычно причина заключается в несовпадении Base URL и ключа
Как удалить свой аккаунт?	Удаление в один клик; восстановить данные невозможно

💬 Все еще не повезло?

Примеры использования

Руководства по интеграции для Cherry Studio, Claude Code, Cursor и других

Цены на модели

Таблица актуальных цен и страницы с подробностями для каждой модели

Актуальные обновления

Ежедневные обновления о статусе моделей, изменениях поставок и инцидентах

Объявления

Новые запуски моделей, изменения цен и обновления функций

Все еще не повезло? Свяжитесь с нами напрямую:

📧 Email: [email protected]
🌐 Console: api.apiyi.com
💰 Pricing: Страница цен

Если ваш вопрос не охвачен, отправьте его в поддержку — мы рассматриваем предложения и добавляем их в FAQ. Новые пользователи получают бесплатные пробные кредиты, так что вы можете проверить вашу интеграцию перед пополнением.

​🚀 Начало работы за 3 шага

Шаг 1: Зарегистрируйтесь

Шаг 2: Создайте ключ

Шаг 3: Выполните API-вызов

​🔥 Популярные вопросы

Как создать ключ?

Как защитить аккаунт?

Почему мой API-ключ недействителен?

Почему не удаётся отправлять запросы при наличии баланса?

Что означает коэффициент модели?

Какие доступны акции на пополнение?

​🔧 Устранение неполадок по симптомам

​📖 Руководства по документации

Интеграция API

Выбор модели

Генерация изображений и видео

Клиенты и агенты

​📚 Просмотр по темам

​🧭 Возможности сайта (4)

​🔑 Tokens и журналы (14)

​🏢 Корпоративные услуги (9)

​💰 Тарификация и безопасность (18)

​🌐 Сеть и подключение (11)

​👤 Аккаунт и вход (7)

​💬 Все еще не повезло?

Примеры использования

Цены на модели

Актуальные обновления

Объявления

🚀 Начало работы за 3 шага

🔥 Популярные вопросы

🔧 Устранение неполадок по симптомам

📖 Руководства по документации

📚 Просмотр по темам

🧭 Возможности сайта (4)

🔑 Tokens и журналы (14)

🏢 Корпоративные услуги (9)

💰 Тарификация и безопасность (18)

🌐 Сеть и подключение (11)

👤 Аккаунт и вход (7)

💬 Все еще не повезло?