В чём разница между TokenCode и прямым вызовом OpenAI/Claude API?
TokenCode — это AI API-агрегирующий шлюз. Через TokenCode вы можете:
Получить доступ ко всем моделям 40+ провайдеров с одним API Key
Использовать автоматическую конвертацию протоколов без адаптации разных SDK для разных моделей
Пользоваться интеллектуальной маршрутизацией, failover и балансировкой нагрузки
Управлять всем через единую панель биллинга и администрирования
Прямой вызов каждого провайдера требует отдельной регистрации, управления несколькими API Key и адаптации под разные протоколы.
Как работает автоматическая конвертация протоколов?
Когда вы вызываете модель Claude по протоколу OpenAI, TokenCode:
Принимает запрос в формате 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://tokencode.dev/v1
Протокол Anthropic: https://tokencode.dev
Протокол Gemini: https://tokencode.dev
Почему 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?
Да. Функция автоматической конвертации протоколов TokenCode поддерживает кросс-протокольный вызов любых моделей. При вызове 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 для проверки
Тайм-аут подключения
Проверьте доступность сети для обращения к tokencode.dev
Убедитесь в правильности написания Base URL
Если используется прокси, проверьте его конфигурацию