В чём разница между Puyun AI и прямым вызовом OpenAI/Claude API?
Puyun AI — это AI API-агрегирующий шлюз. Через Puyun AI вы можете:
Получить доступ ко всем моделям 40+ провайдеров с одним API Key
Использовать автоматическую конвертацию протоколов без адаптации разных SDK для разных моделей
Пользоваться интеллектуальной маршрутизацией, failover и балансировкой нагрузки
Управлять всем через единую панель биллинга и администрирования
Прямой вызов каждого провайдера требует отдельной регистрации, управления несколькими API Key и адаптации под разные протоколы.
Как работает автоматическая конвертация протоколов?
Когда вы вызываете модель Claude по протоколу OpenAI, Puyun AI:
Принимает запрос в формате OpenAI
Конвертирует его в нативный формат Anthropic и отправляет upstream
Конвертирует нативный ответ Anthropic в формат OpenAI и возвращает вам
Обратное тоже верно — вызов моделей OpenAI по протоколу Anthropic также конвертируется автоматически. Весь процесс полностью прозрачен для клиента.
Какие модели поддерживаются?
Поддерживаются модели от OpenAI, Anthropic, Google, AWS Bedrock, Azure, DeepSeek, Mistral, Meta и более 40 провайдеров. Полный список моделей доступен на главной странице или через интерфейс GET /v1/models.
Войдите в Portal, выберите сумму пополнения на странице аккаунта. Поддерживается предоплаченная модель — потребление Token списывается с баланса в реальном времени.
Что происходит при недостаточном балансе?
Когда баланс исчерпан, API-запросы будут возвращать ошибку 429 Too Many Requests. Пожалуйста, своевременно пополняйте баланс для восстановления сервиса.
Как просмотреть использование?
Войдите в Portal — на странице использования можно просмотреть потребление Token и детали расходов по датам и моделям.
Подключение и настройка
Какой API Base URL использовать?
Протокол OpenAI: https://ai.tracup.com/v1
Протокол Anthropic: https://ai.tracup.com
Протокол Gemini: https://ai.tracup.com
Почему Base URL протокола OpenAI содержит /v1, а Anthropic — нет?
Это стандартное соглашение протоколов:
OpenAI SDK по умолчанию добавляет пути вроде /chat/completions к base URL, поэтому base URL должен содержать /v1
Anthropic SDK по умолчанию добавляет /v1/messages к base URL, поэтому base URL не должен содержать /v1
Поддерживаются ли потоковые ответы?
Да. Эндпоинты всех протоколов поддерживают потоковый вывод — просто установите stream: true.
Модели и функции
Можно ли вызывать модели OpenAI через протокол Anthropic?
Да. Функция автоматической конвертации протоколов Puyun AI поддерживает кросс-протокольный вызов любых моделей. При вызове GPT-4o через протокол Anthropic запросы и ответы автоматически адаптируются.
Поддерживается ли Function Calling?
Да. Function Calling / Tool Use корректно отображается при конвертации протоколов.
Поддерживается ли ввод изображений?
Да. Протоколы OpenAI, Anthropic и Gemini поддерживают ввод изображений (Vision). Формат см. в справочной документации API каждого протокола.
Поддерживается ли Extended Thinking?
Extended Thinking — это специфичная функция моделей Claude, доступная только при вызове моделей Claude по протоколу Anthropic. Эта функция не поддерживается при вызове не-Claude моделей через конвертацию протоколов.
Устранение ошибок
Возвращается ошибка 401
Проверьте правильность API Key
Подтвердите формат заголовка: Authorization: Bearer sk-xxx или x-api-key: sk-xxx
Убедитесь, что API Key не истёк
Возвращается ошибка 429
Недостаточный баланс: пополните баланс в Portal
Ограничение скорости: подождите некоторое время и повторите попытку, либо перейдите на более высокий уровень сервиса
Возвращается ошибка 404
Проверьте правильность пути запроса
Убедитесь в правильности написания имени модели
Подтвердите правильность настройки Base URL (протокол OpenAI требует /v1)
Некорректный формат ответа
Убедитесь, что используемый эндпоинт протокола соответствует клиенту
Проверьте, поддерживает ли модель используемую вами функцию
Попробуйте выполнить прямой запрос через curl для проверки
Тайм-аут подключения
Проверьте доступность сети для обращения к ai.tracup.com
Убедитесь в правильности написания Base URL
Если используется прокси, проверьте его конфигурацию