Перейти к основному содержимому

Частые вопросы

Сначала проверьте API-запрос и настройки клиента, затем переходите к конкретной ошибке.

API-запросы​

Как проверить, что API Key скопирован полностью​

Key обычно показывается полностью только один раз. Скопируйте его в безопасное место и проверьте пробелы, переносы строк и типографские кавычки. Если полное значение больше не видно, отключите старый Key и создайте новый, не угадывая его.

Сначала проверять приложение или curl​

Сначала проверьте curl. Адрес, Key, модель и тело запроса видны явно, поэтому проще исключить кэш клиента и наследование переменных окружения.

Почему curl работает, а приложение нет​

Проверьте тип Provider, уровень Base URL, поля API Key и Model, затем создайте новый диалог или перезапустите клиент.

Чем Base URL отличается от полного Endpoint​

Base URL является корнем протокола, а клиент добавляет путь. Полный Endpoint уже содержит путь конкретной операции.

Почему список моделей пуст​

Многие клиенты не получают списки сторонних моделей автоматически. Если Key и Base URL верны, скопируйте YOUR_MODEL со страницы моделей и цен и укажите его вручную.

Как понять, что не хватает аккаунта или квоты​

Если после проверки Key, модели и пути запрос возвращает 403 или 429, проверьте в портале состояние аккаунта, квоту и доступность текущей модели. Не ориентируйтесь на старый скриншот из публичной документации.

Изоляция проблемы минимальным запросом​

Зафиксируйте URL, Key, модель и тело и отправьте короткое сообщение. Успешный curl указывает на настройки клиента или старый сеанс; при ошибке используйте HTTP-статус в разделе исправления.

Клиент и локальная среда​

Команда не найдена​

  • Симптом: Клиент или терминал показывает «Команда не найдена», либо настройка сохранена, но запросы не проходят.
  • Причина: Терминал не находит claude, codex или gemini, обычно потому что каталог установки не в PATH или старый терминал не обновил окружение.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Откройте новый терминал и выполните команду версии. Если ошибка остается, переустановите из официального источника и не используйте неизвестные зеркала.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Переменные окружения не применяются​

  • Симптом: Клиент или терминал показывает «Переменные окружения не применяются», либо настройка сохранена, но запросы не проходят.
  • Причина: Переменные заданы в одном терминале, а приложение запускается из другого старого окна, ярлыка или фонового процесса.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Выведите переменные в том же терминале, который запускает приложение, затем закройте старые сеансы и откройте заново.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Сохраненные настройки все еще используют сервис по умолчанию​

  • Симптом: Клиент или терминал показывает «Сохраненные настройки все еще используют сервис по умолчанию», либо настройка сохранена, но запросы не проходят.
  • Причина: Клиент мог закэшировать старый Provider, или текущий диалог не переключен на новую настройку.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Создайте новый диалог или перезапустите клиент и проверьте, что Provider, Base URL, Key и модель взяты из PopGo.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Модель недоступна​

  • Симптом: Клиент или терминал показывает «Модель недоступна», либо настройка сохранена, но запросы не проходят.
  • Причина: Изменились написание ID модели, область доступа или текущая доступность.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Скопируйте ID модели снова со страницы моделей и цен и проверьте минимальным запросом, не набирая по старому скриншоту.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Ошибка прав при глобальной установке npm​

  • Симптом: Клиент или терминал показывает «Ошибка прав при глобальной установке npm», либо настройка сохранена, но запросы не проходят.
  • Причина: В Windows может не хватать прав установки, а в macOS/Linux глобальный каталог может быть недоступен для записи из-за способа установки Node.js.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: В Windows при необходимости откройте PowerShell с подходящими правами заново. В macOS/Linux используйте официальный способ или менеджер пакетов, чтобы глобальный каталог принадлежал текущему пользователю; не полагайтесь постоянно на sudo npm install -g.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Claude Code требует вход в официальный аккаунт​

  • Симптом: Клиент или терминал показывает «Claude Code требует вход в официальный аккаунт», либо настройка сохранена, но запросы не проходят.
  • Причина: Claude Code не прочитал переменные окружения и вернулся к официальному сценарию входа.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Проверьте ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в том же терминале, закройте старые окна, перезапустите инструмент и выполните claude doctor.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Codex сообщает об ошибке аутентификации​

  • Симптом: Клиент или терминал показывает «Codex сообщает об ошибке аутентификации», либо настройка сохранена, но запросы не проходят.
  • Причина: Локальная настройка не читает POPGO_API_KEY, либо Provider, model_provider и env_key в config.toml не соответствуют друг другу.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Убедитесь, что имя переменной точно POPGO_API_KEY, затем проверьте соответствие model_provider = popgo и model_providers.popgo.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

После указания Base URL возвращается 404​

  • Симптом: Клиент или терминал показывает «После указания Base URL возвращается 404», либо настройка сохранена, но запросы не проходят.
  • Причина: Приложение может добавить путь к введенному адресу, получив /v1/v1 или дублированный полный Endpoint.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Откройте таблицу уровней Base URL в Quickstart: в поле Base URL указывайте корень протокола, а полный путь вводите только в поле полного Endpoint.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Ошибка сертификата или SSL​

  • Симптом: Клиент или терминал показывает «Ошибка сертификата или SSL», либо настройка сохранена, но запросы не проходят.
  • Причина: Частые причины: локальный прокси, перехват корпоративной сети, неверное системное время или поврежденная цепочка сертификатов.
  • Проверки:
    1. Проверьте команду, переменные окружения, Provider, Base URL, Key и модель в том же сеансе, который запускает клиент.
    2. Закройте старые сеансы и процессы и запустите клиент заново.
    3. Сверьте итоговый URL с таблицей быстрого старта.
  • Исправление: Не отключайте проверку TLS. Проверьте часы, попробуйте без локального прокси или в другой сети и проверьте перехват HTTPS защитным ПО.
  • Проверка: Перезапустите клиент и отправьте короткое сообщение. Восстановление подтверждается обычным ответом с ожидаемыми URL, моделью и авторизацией.

Чем входное аудио отличается от выходного?​

generate_audio управляет выходной дорожкой, не подтверждая аудиовход. Возможности определяют названия видео/аудио,только видео,только аудио. Видеорежим требует видео, аудиорежим — аудио.

Почему C принимает аудио, но не видео?​

C явно исключает видео; пустое значение не должно обходить0. Допускается до3 референсных аудиофайлов. Kling не опубликовал аудиовходные поля и они закрыты; Grok тоже их исключает.

Вставка онлайн-медиа всегда сохраняет URL?​

Явный HTTP(S) адрес сохраняется, но копирование только байтов остаётся локальным. Генерация публична лишь при сохранённом sourceUrl. Метка показывает источник, не гарантируя доступа сервиса. Без Base64 требуется доступный URL.

Почему ID есть, а референс не действует?​

ID доказывает лишь принятие. Проверьте режим,поля,загрузку и результат. Первый кадр не равен обычному референсу; проигнорированное поле может не остановить списание. См.Видеозадачи.

Рекомендуемый порядок проверки​

  1. Сначала сохраните полную ошибку: HTTP-статус, путь, клиент и время.
  2. Повторите запрос минимальным curl из быстрого старта, чтобы отделить Key, модель, URL и клиент.
  3. Меняйте только одну переменную за раз. Сначала проверьте короткий текстовый запрос, затем возвращайте streaming, tools или медиапараметры.