01Кабинет
Создайте API-ключ
Авторизуйтесь в кабинете AI API Hub и создайте ключ на странице Dashboard. Скопируйте его — он понадобится на следующем шаге.
Интеграции
OpenCode + AI API Hub
Используйте российский OpenAI-compatible gateway внутри OpenCode. Создайте ключ, добавьте конфигурацию и получайте ответы от Claude, GPT, Gemini и других моделей через единый API.
Как подключить
Четыре шага до первого запроса
02Терминал
Запустите /connect в OpenCode
В терминале, внутри проекта или в глобальном режиме, выполните команду /connect. Прокрутите список провайдеров вниз и выберите Other.
03Конфигурация
Укажите ID провайдера
Введите уникальный ID, например ai-api-hub-russia. Этот же ID используется в opencode.json, поэтому важно использовать одинаковое значение.
04Файл
Добавьте opencode.json
В корне проекта создайте файл opencode.json с конфигурацией ниже. После сохранения выполните /models и выберите модель AI API Hub.
opencode.json
Готовый конфиг
Скопируйте файл в корень проекта. Поле baseURL указывает на публичный endpoint AI API Hub, а models содержит публичные slug, доступные через каталог.
AI API Hub — OpenAI-compatible gateway. Подходит для /v1/chat/completions, поэтому используем пакет @ai-sdk/openai-compatible.
Если вы планируете использовать модели с /v1/responses, замените npm на @ai-sdk/openai для соответствующего slug.
Добавьте в .env переменную AI_HUB_API_KEY и укажите её в опции apiKey через {env:AI_HUB_API_KEY}, чтобы не хранить ключ в файле.
JSONopencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"ai-api-hub-russia": {
"npm": "@ai-sdk/openai-compatible",
"name": "AI API Hub",
"options": {
"baseURL": "https://crea-ai.ru"
},
"models": {
"claude-best": { "name": "Claude Best" },
"gpt-coding": { "name": "GPT Coding" },
"gpt-fast": { "name": "GPT Fast" },
"codex-pro": { "name": "Codex Pro" }
}
}
}
}Советы
Рекомендации по использованию
Выбор модели
После добавления конфигурации выполните /models и выберите подходящий slug. Для код-генерации рекомендуем claude-best или codex-pro.
Headers
Для контроля расходов используйте X-Max-Cost-RUB и X-Request-Project. Они передаются как обычные HTTP-заголовки в каждом запросе.
Безопасность
Не храните API-ключ в репозитории. Используйте переменные окружения и синтаксис {env:AI_HUB_API_KEY} в opencode.json.
FAQ
Частые вопросы по OpenCode
Можно ли использовать AI API Hub в глобальном конфиге OpenCode, а не в проекте?
Да. Разместите opencode.json в домашней директории (~/.config/opencode/opencode.json или ~/.opencode.json — зависит от версии). Тогда провайдер будет доступен во всех проектах без необходимости копировать файл.
Какой пакет указывать в поле npm — @ai-sdk/openai или @ai-sdk/openai-compatible?
Используйте @ai-sdk/openai-compatible. Он предназначен для OpenAI-совместимых API, к которым относится AI API Hub. Пакет @ai-sdk/openai работает только с официальным OpenAI API и не поддерживает кастомный baseURL.
Как передать API-ключ не хардкодом в файл, а через переменную окружения?
В поле apiKey внутри options используйте синтаксис {env:AI_HUB_API_KEY}. OpenCode подставит значение из переменной окружения. Добавьте AI_HUB_API_KEY в .env или в переменные системы, чтобы ключ не попал в репозиторий.
Почему OpenCode не видит мои модели после добавления конфига?
Убедитесь, что ID провайдера в opencode.json совпадает с тем, что вы ввели при /connect. Затем перезапустите OpenCode — изменения в конфиге применяются при старте. Выполните /models и найдите AI API Hub в списке.
Поддерживает ли AI API Hub потоковую передачу (streaming) в OpenCode?
Да, все chat-модели поддерживают streaming. OpenCode использует его по умолчанию — ответ появляется посимвольно, не нужно дополнительных настроек.
Какую модель лучше использовать для написания кода?
Для задач кодогенерации и рефакторинга рекомендуем claude-best или codex-pro. Для быстрых ответов и объяснений подойдёт gpt-fast. Посмотреть полный каталог с возможностями и ценами можно в разделе Модели.
Готовы попробовать?
Создайте ключ, скопируйте конфиг и начните работать с AI-моделями через OpenCode.