Використання OpenCode з CometAPI

Скористайтеся цим посібником, щоб запустити OpenCode з CometAPI. Ця конфігурація надає чотири формати API через окремих користувацьких провайдерів. Цю конфігурацію протестовано з OpenCode 1.18.16. Офіційні довідкові матеріали:

Замініть кожне значення your-model-id на ID моделі зі сторінки CometAPI Models. Виберіть модель, яка підтримує формат API відповідного запису провайдера.

Передумови

Node.js і npm або інший спосіб встановлення з посібника OpenCode
Обліковий запис CometAPI з активним API key із панелі керування
Один або кілька ID моделей зі сторінки CometAPI Models

Ознайомтеся з форматами API

Кожен ID провайдера вибирає один адаптер SDK і один формат API.

ID провайдера	Адаптер OpenCode	Базова URL-адреса	Формат API
`cometapi-chat`	`@ai-sdk/openai-compatible`	`https://api.cometapi.com/v1`	Chat Completions
`cometapi-responses`	`@ai-sdk/openai`	`https://api.cometapi.com/v1`	Responses
`cometapi-messages`	`@ai-sdk/anthropic`	`https://api.cometapi.com/v1`	Anthropic Messages
`cometapi-gemini`	`@ai-sdk/google`	`https://api.cometapi.com/v1beta`	Gemini generateContent

У цьому посібнику перевіряється операція Streaming для Gemini, яка використовується під час звичайного ходу агента OpenCode. Адаптер Google додає :streamGenerateContent?alt=sse до шляху моделі. Не додавайте /chat/completions, /responses, /messages або шлях до моделі Gemini до baseURL. Кожен адаптер додає необхідний шлях операції.

Ознайомтеся з дозволами під час виконання

OpenCode запускається з дозволами процесу, який його запускає. Запускайте OpenCode у потрібному каталозі проєкту та зберігайте можливість відкату, наприклад за допомогою git. Використовуйте контейнер або пісочницю, коли вам потрібна надійніша ізоляція файлової системи, процесів, мережі або API key.

Налаштування OpenCode

Установлення OpenCode

Установіть OpenCode за допомогою офіційного пакета npm:

npm install -g opencode-ai

Переконайтеся, що CLI доступний:

opencode --version

Див. посібник зі встановлення OpenCode щодо Homebrew, Windows, Docker та інших способів встановлення.

Налаштування API-ключа CometAPI

Збережіть API-ключ CometAPI у змінній середовища COMETAPI_KEY.

macOS / Linux / WSL
Windows PowerShell

Зчитайте API-ключ, не відображаючи його в терміналі:

read -rsp "CometAPI API key: " COMETAPI_KEY
printf '\n'
export COMETAPI_KEY

Зчитайте API-ключ у поточний сеанс PowerShell:

$secureKey = Read-Host "CometAPI API key" -AsSecureString
$env:COMETAPI_KEY = [System.Net.NetworkCredential]::new(
  "",
  $secureKey
).Password

Установлюйте змінну в кожному сеансі оболонки, з якого запускається OpenCode. Не зберігайте API-ключі в системі контролю версій.

Виберіть розташування конфігурації

Використовуйте одне з цих підтримуваних розташувань:

Глобальна конфігурація: ~/.config/opencode/opencode.json
Конфігурація проєкту: opencode.json у корені проєкту

OpenCode об’єднує файли конфігурації. Конфігурація проєкту перевизначає конфліктні значення з глобальної конфігурації.Використовуйте глобальний файл, якщо потрібні провайдери в кожному проєкті. Використовуйте файл проєкту, якщо репозиторію потрібні власні записи моделей.

Додайте провайдери CometAPI

Створіть вибраний файл конфігурації. Якщо файл уже містить provider об’єкт, об’єднайте ці чотири записи з цим об’єктом:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cometapi-chat": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CometAPI Chat Completions",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Chat model"
        }
      }
    },
    "cometapi-responses": {
      "npm": "@ai-sdk/openai",
      "name": "CometAPI Responses",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Responses model"
        }
      }
    },
    "cometapi-messages": {
      "npm": "@ai-sdk/anthropic",
      "name": "CometAPI Anthropic Messages",
      "options": {
        "baseURL": "https://api.cometapi.com/v1",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Messages model"
        }
      }
    },
    "cometapi-gemini": {
      "npm": "@ai-sdk/google",
      "name": "CometAPI Gemini",
      "options": {
        "baseURL": "https://api.cometapi.com/v1beta",
        "apiKey": "{env:COMETAPI_KEY}"
      },
      "models": {
        "your-model-id": {
          "name": "CometAPI Gemini model"
        }
      }
    }
  }
}

Замініть кожен ключ your-model-id окремо. У чотирьох записах можна використовувати різні ідентифікатори моделей.Конфігурація не задає model верхнього рівня. Це дає змогу вибрати потрібний формат API та модель через /models.

Не використовуйте /connect для цієї конфігурації. Поля apiKey зчитуються COMETAPI_KEY із середовища. Незадана змінна набуває порожнього значення замість збереженого API-ключа /connect.

Виберіть і перевірте кожен провайдер

Запустіть OpenCode у проєкті, до якого він має отримати доступ:

opencode

Виконайте /models, а потім виберіть запис provider/model. Під час чотирьох перевірок у цьому посібнику кожен виклик моделі використовував відповідний формат API вибраного запису. Розсилання запитів між форматами чи автоматичного узгодження формату API не спостерігалося.Щоб перевірити Chat Completions з командного рядка, виконайте:

opencode run \
  --model cometapi-chat/your-model-id \
  "Reply exactly with: COMETAPI_CHAT_OK"

Щоб перевірити Responses з командного рядка, виконайте:

opencode run \
  --model cometapi-responses/your-model-id \
  "Reply exactly with: COMETAPI_RESPONSES_OK"

Щоб перевірити Anthropic Messages з командного рядка, виконайте:

opencode run \
  --model cometapi-messages/your-model-id \
  "Reply exactly with: COMETAPI_MESSAGES_OK"

Щоб перевірити Gemini generateContent з командного рядка, виконайте:

opencode run \
  --model cometapi-gemini/your-model-id \
  "Reply exactly with: COMETAPI_GEMINI_OK"

Усунення несправностей

OpenCode не відображає модель CometAPI

Переконайтеся, що конфігурація є коректним JSON. Кожен користувацький запис має бути в об’єкті верхнього рівня provider, а кожен ID моделі має бути в відповідному об’єкті models. Перезапустіть OpenCode, а потім знову відкрийте /models.

OpenCode повідомляє про помилку API key або автентифікації

Переконайтеся, що COMETAPI_KEY задано в оболонці, з якої запускається OpenCode. Незадане посилання {env:COMETAPI_KEY} перетворюється на порожнє значення. Відкрийте нову оболонку після зміни профілю оболонки.

ID моделі недоступний

Перевірте сторінку моделей CometAPI, а потім замініть модель ID у вибраному записі провайдера. Переконайтеся, що модель підтримує API format цього провайдера.

Запити використовують неправильний шлях

Залиште baseURL зі значенням /v1 для Chat Completions, Responses і Messages. Використовуйте /v1beta для Gemini. Не включайте шлях операції до baseURL.

Один провайдер працює, а інший — ні

Використовуйте ID моделі, що підтримує API format вибраного провайдера. Не вважайте, що один ID моделі підтримує всі чотири формати.

Конфігурація проєкту змінює глобального провайдера

OpenCode об’єднує глобальну та проєктну конфігурації. Перейменуйте ідентифікатор провайдера у проєкті або видаліть його конфліктні значення, якщо хочете, щоб глобальний запис провайдера залишився без змін.

OpenCode має більше доступу, ніж очікувалося

OpenCode використовує дозволи процесу, який його запустив. Запускайте OpenCode у контейнері або ізольованому середовищі, коли потрібні суворіші межі доступу.

Огляд

AI агенти для програмування

AI-агенти

AI чат-клієнти

Переклад і мова

Платформи автоматизації

Спостережуваність та оцінювання

AI фреймворки

Використання OpenCode з CometAPI

Передумови

Ознайомтеся з форматами API

Ознайомтеся з дозволами під час виконання

Налаштування OpenCode

Усунення несправностей

Пов’язані ресурси

​Передумови

​Ознайомтеся з форматами API

​Ознайомтеся з дозволами під час виконання

​Налаштування OpenCode

​Усунення несправностей

​Пов’язані ресурси

Передумови

Ознайомтеся з форматами API

Ознайомтеся з дозволами під час виконання

Налаштування OpenCode

Усунення несправностей

Пов’язані ресурси