Начало работы

Использование в приложениях

Используйте ключ в приложениях, которые у вас уже есть, — без кода. Выберите приложение, скопируйте его настройки, и готово. Эти шаги — для моделей GPT.

#1. Выберите приложение

Приложения для чата и перевода

Инструменты для программирования

Свой код

#2. Скопируйте настройки

Cherry Studio

Откройте: Settings (设置) → Model Providers (模型服务) → OpenAI

API Host

Модель

"API Host" автоматически дописывает /v1/chat/completions. Указывайте URL только до хоста (или до /v1); добавьте # в конце, чтобы отключить автодописывание.

Храните API-ключ в секрете

Храните ключ в переменной окружения или менеджере секретов. Никогда не вставляйте постоянный ключ в браузерный код, на скриншоты или в репозиторий.

#3. Проверьте, что всё работает

  1. Выберите модель в приложении и отправьте короткое сообщение, например «привет».
  2. Если пришёл ответ, подключение работает. Вызов появится в разделе Консоль → Использование.
  3. Если приложение не принимает ключ, проверьте, нужен ли ему адрес с /v1 или без.

#Инструменты MCP

Подключение моделей и MCP настраиваются отдельно

aisplice даёт доступ к моделям. MCP-серверы дают внешние инструменты и данные. Настройте провайдера aisplice и каждый MCP-сервер отдельно в Codex, Cursor или другом клиенте.

Для Codex добавьте удалённый MCP-сервер через CLI или поместите аналогичный блок в ~/.codex/config.toml:

Codex MCP
# CLI
codex mcp add my-tools --url https://mcp.example.com/mcp

# equivalent ~/.codex/config.toml
[mcp_servers.my-tools]
url = "https://mcp.example.com/mcp"

Аутентификация MCP настраивается отдельно

API-ключ aisplice используется только для запросов к моделям. Для OAuth, заголовков или переменных окружения следуйте инструкциям провайдера MCP-сервера, затем перезапустите клиент, чтобы он перечитал конфигурацию.

#Переход с OpenAI SDK

#Изменение в две строки

Для большинства проектов это и есть весь PR. Поскольку формат совместим с OpenAI, потоковая передача, вызов инструментов, распознавание изображений и структурированный вывод продолжают работать с вашим текущим кодом.

const client = new OpenAI({
- baseURL: "https://api.openai.com/v1",
+ baseURL: "https://www.aisplice.store/v1",
- apiKey: process.env.OPENAI_API_KEY,
+ apiKey: process.env.GATEWAY_API_KEY,
});

Проблема не решена?

Пришлите нам ID запроса или текст ошибки, и мы разберёмся.