Планируется

Xcode и API Токенмоста: безопасная архитектура

Как подключать модели в macOS/iOS-разработке через серверный слой, не встраивая API-ключ в приложение или расширение Xcode.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Xcode — среда разработки, а не универсальный клиент для пользовательского OpenAI endpoint. Для приложения на Swift используйте свой серверный маршрут, который проверяет пользователя и вызывает API Токенмоста. Встраивать ключ прямо в iOS-сборку нельзя: его можно извлечь.

Что потребуется

Свой сервер с авторизацией пользователей и хранением секрета.
Отдельный ключ Токенмоста с бюджетом и RPM.
Сценарий приложения: текстовый диалог или инструмент в Source Editor Extension.

Порядок работы

Определите, где нужен ответ модели: в приложении или в расширении редактора Xcode.
Сделайте серверный endpoint с проверкой пользователя, квотой и ограничением размера запроса.
Храните ключ Токенмоста только на сервере и передавайте его в Bearer-заголовке при вызове Chat Completions.
В Swift-клиенте обращайтесь только к своему endpoint; не копируйте API-ключ в код, plist или бинарник.
Начните с короткого текстового ответа и проверьте расходы и ошибки на сервере.
Если создаёте Source Editor Extension, отдельно тестируйте разрешения на чтение и изменение выделенного текста.

Готовая конфигурация

Схема вызова

Приложение Swift или расширение Xcode → ваш сервер (авторизация и квота)
Ваш сервер → https://tokenmost.ru/v1/chat/completions (Bearer-ключ)
Ваш сервер → проверка ответа и расхода → приложение Swift

Что учесть

Не размещайте API-ключ в мобильном клиенте или расширении. Прямое встраивание Токенмоста в интерфейс Xcode не подтверждено; безопасный путь — собственный серверный слой.

Ожидаемый результат

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

Граница Xcode

Apple XcodeKit позволяет создать Source Editor Extension, но это отдельная разработка. Универсальной кнопки подключить Tokenmost в Xcode здесь не заявляется.

Расходы

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

Ошибки и диагностика

Ключ оказался в сборке

Отзовите его, выпустите новый и перенесите вызов на сервер.

HTTP 401 на сервере

Проверьте секрет сервера и Bearer-заголовок.

HTTP 402

Проверьте баланс и бюджет ключа до запуска клиентских повторов.

Дубли после плохой связи

Сохраняйте Idempotency-Key операции на своём сервере и повторяйте то же тело.

Xcode не показывает провайдера

Нативного переключателя не заявлено; используйте приложение или Source Editor Extension.

Источники и связанные инструкции

Читайте дальше

← Все инструкции