OpenCode gebruiken met CometAPI

Gebruik deze handleiding om OpenCode met CometAPI. De configuratie stelt vier API-indelingen beschikbaar via afzonderlijke aangepaste providers. Deze configuratie is getest met OpenCode 1.18.16. Officiële referenties:

Vervang elke your-model-id-waarde door een model-ID van de CometAPI Models-pagina. Kies een model dat de API indeling van de omringende providervermelding accepteert.

Vereisten

Node.js en npm, of een andere installatiemethode uit de OpenCode-handleiding
Een CometAPI-account met een actieve API-sleutel uit het dashboard
Een of meer model-ID’s van de CometAPI Models-pagina

De API-indelingen begrijpen

Elke provider-ID selecteert één SDK-adapter en één API-indeling.

Provider-ID	OpenCode-adapter	Basis-URL	API-indeling
`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

Deze handleiding controleert de Gemini-streamingbewerking die tijdens een normale draai van de OpenCode-agent wordt gebruikt. De Google-adapter voegt :streamGenerateContent?alt=sse toe aan het modelpad. Voeg geen /chat/completions, /responses, /messages of een Gemini-modelpad toe aan baseURL. Elke adapter voegt het vereiste bewerkingspad toe.

Runtime-machtigingen begrijpen

OpenCode wordt uitgevoerd met de machtigingen van het proces waarmee u het start. Start OpenCode in de bedoelde projectdirectory en houd een herstelmogelijkheid achter de hand, zoals git. Gebruik een container of sandbox wanneer u sterkere grenzen voor het bestandssysteem, processen, netwerk of API-sleutels nodig hebt.

OpenCode configureren

OpenCode installeren

Installeer OpenCode met het officiële npm-pakket:

npm install -g opencode-ai

Bevestig dat de CLI beschikbaar is:

opencode --version

Zie de installatiehandleiding voor OpenCode voor Homebrew, Windows, Docker en andere installatiemethoden.

Uw CometAPI API-sleutel instellen

Sla uw CometAPI API-sleutel op in de omgevingsvariabele COMETAPI_KEY.

macOS / Linux / WSL
Windows PowerShell

Lees de API-sleutel zonder deze in de terminal weer te geven:

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

Lees de API-sleutel in de huidige PowerShell-sessie:

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

Stel de variabele in in elke shellsessie die OpenCode start. Sla API-sleutels niet op in versiebeheer.

Een configuratielocatie kiezen

Gebruik een van deze ondersteunde locaties:

Globale configuratie: ~/.config/opencode/opencode.json
Projectconfiguratie: opencode.json in de hoofdmap van het project

OpenCode voegt configuratiebestanden samen. Een projectconfiguratie overschrijft conflicterende waarden uit de globale configuratie.Gebruik het globale bestand als u de providers in elk project wilt gebruiken. Gebruik het projectbestand wanneer een repository eigen modelvermeldingen nodig heeft.

De CometAPI-providers toevoegen

Maak het geselecteerde configuratiebestand. Als het bestand al een provider object bevat, voegt u deze vier vermeldingen samen in dat object:

{
  "$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"
        }
      }
    }
  }
}

Vervang elke your-model-id-key afzonderlijk. De vier vermeldingen kunnen verschillende model-ID’s gebruiken.De configuratie stelt geen model op hoofdniveau in. Hiermee kunt u kiezen de vereiste API-indeling en het model via /models.

Gebruik /connect niet voor deze configuratie. De velden apiKey lezen COMETAPI_KEY uit de omgeving. Een niet-ingestelde variabele wordt omgezet in een lege waarde in plaats van een opgeslagen /connect API-sleutel.

Elke provider selecteren en verifiëren

Start OpenCode in het project waartoe u toegang wilt geven:

opencode

Voer /models uit en selecteer vervolgens een provider/model-vermelding. In de vier controles voor deze handleiding gebruikte elke modelbeurt de API indeling die overeenkwam met de geselecteerde vermelding. Er werd geen fan-out van aanvragen tussen indelingen of automatische onderhandeling over API-indelingen waargenomen.Voer het volgende uit om Chat Completions vanaf de opdrachtregel te verifiëren:

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

Voer het volgende uit om Responses vanaf de opdrachtregel te verifiëren:

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

Voer het volgende uit om Anthropic Messages vanaf de opdrachtregel te verifiëren:

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

Voer het volgende uit om Gemini generateContent vanaf de opdrachtregel te verifiëren:

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

Probleemoplossing

OpenCode toont geen CometAPI-model

Controleer of de configuratie geldige JSON is. Elke aangepaste vermelding moet zich binnen het object provider op het hoogste niveau bevinden en elke model-ID moet zich binnen het overeenkomstige object models bevinden. Herstart OpenCode en open vervolgens /models opnieuw.

OpenCode meldt een API-sleutel- of authenticatiefout

Controleer of COMETAPI_KEY is ingesteld in de shell waarmee OpenCode wordt gestart. Een niet-ingestelde verwijzing naar {env:COMETAPI_KEY} wordt een lege waarde. Open een nieuwe shell nadat je een shellprofiel hebt gewijzigd.

Een model-ID is niet beschikbaar

Controleer de CometAPI Models-pagina, en vervang vervolgens de model- ID binnen de vermelding van de geselecteerde provider. Controleer of het model de API-indeling van die provider accepteert.

Verzoeken gebruiken een onjuist pad

Houd baseURL op /v1 voor Chat Completions, Responses en Messages. Gebruik /v1beta voor Gemini. Neem geen bewerkingspad op in baseURL.

Eén provider werkt, maar een andere provider faalt

Gebruik een model-ID die de API-indeling van de geselecteerde provider accepteert. Ga er niet van uit dat één model-ID alle vier de indelingen accepteert.

De projectconfiguratie wijzigt een globale provider

OpenCode voegt globale en projectconfiguratie samen. Wijzig de naam van de project- provider-ID of verwijder de conflicterende waarden als je wilt dat de globale providervermelding ongewijzigd blijft.

OpenCode heeft meer toegang dan verwacht

OpenCode gebruikt de machtigingen van het proces waarmee het is gestart. Voer OpenCode uit in een container of sandbox wanneer je strengere toegangsgrenzen nodig hebt.

Overzicht

AI-codeeragents

AI-agents

AI-chatclients

Vertaling en taal

Automatiseringsplatforms

Observeerbaarheid en evaluatie

AI-frameworks

Vereisten

De API-indelingen begrijpen

Runtime-machtigingen begrijpen

OpenCode configureren

Probleemoplossing

Gerelateerde bronnen

​Vereisten

​De API-indelingen begrijpen

​Runtime-machtigingen begrijpen

​OpenCode configureren

​Probleemoplossing

​Gerelateerde bronnen

Vereisten

De API-indelingen begrijpen

Runtime-machtigingen begrijpen

OpenCode configureren

Probleemoplossing

Gerelateerde bronnen