Bruk OpenCode med CometAPI

Bruk denne veiledningen til å kjøre OpenCode med CometAPI. Konfigurasjonen eksponerer fire API-formater gjennom separate egendefinerte leverandører. Denne konfigurasjonen ble testet med OpenCode 1.18.16. Offisielle referanser:

Erstatt hver your-model-id-verdi med en modell-ID fra CometAPI Models-siden. Velg en modell som støtter API- formatet for den omkringliggende leverandøroppføringen.

Forutsetninger

Node.js og npm, eller en annen installasjonsmetode fra OpenCode-veiledningen
En CometAPI-konto med en aktiv API-nøkkel fra dashbordet
Én eller flere modell-ID-er fra CometAPI Models-siden

Forstå API-formatene

Hver leverandør-ID velger én SDK-adapter og ett API-format.

Leverandør-ID	OpenCode-adapter	Basis-URL	API-format
`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

Denne veiledningen verifiserer Gemini-strømmeoperasjonen som brukes under en vanlig agent-runde i OpenCode. Google-adapteren legger til :streamGenerateContent?alt=sse i modellstien. Ikke legg til /chat/completions, /responses, /messages eller en Gemini-modell sti i baseURL. Hver adapter legger til den nødvendige operasjonsstien.

Forstå kjøretidstillatelser

OpenCode kjører med tillatelsene til prosessen som starter det. Start OpenCode i den tiltenkte prosjektkatalogen, og behold en tilbakeføringsmulighet, for eksempel git. Bruk en container eller sandkasse når du trenger sterkere grenser for filsystem, prosesser, nettverk eller API-nøkler.

Konfigurer OpenCode

Installer OpenCode

Installer OpenCode med den offisielle npm-pakken:

npm install -g opencode-ai

Bekreft at CLI-en er tilgjengelig:

opencode --version

Se installasjonsveiledningen for OpenCode for Homebrew, Windows, Docker og andre installasjonsmetoder.

Angi CometAPI API-nøkkelen din

Lagre CometAPI API-nøkkelen din i miljøvariabelen COMETAPI_KEY.

macOS / Linux / WSL
Windows PowerShell

Les API-nøkkelen uten å vise den i terminalen:

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

Les API-nøkkelen inn i den gjeldende PowerShell-økten:

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

Angi variabelen i hver skalløkt som starter OpenCode. Ikke legg API-nøkler inn i versjonskontroll.

Velg en konfigurasjonsplassering

Bruk én av disse støttede plasseringene:

Global konfigurasjon: ~/.config/opencode/opencode.json
Prosjektkonfigurasjon: opencode.json i prosjektroten

OpenCode slår sammen konfigurasjonsfiler. En prosjektkonfigurasjon overstyrer verdier som er i konflikt, fra den globale konfigurasjonen.Bruk den globale filen når du vil ha leverandørene i alle prosjekter. Bruk prosjektfilen når et repositorium trenger egne modelloppføringer.

Legg til CometAPI-leverandørene

Opprett den valgte konfigurasjonsfilen. Hvis filen allerede inneholder et provider objekt, fletter du disse fire oppføringene inn i det objektet:

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

Erstatt hver your-model-id-nøkkel uavhengig av de andre. De fire oppføringene kan bruke ulike modell-ID-er.Konfigurasjonen angir ikke en model på toppnivå. Dette lar deg velge det nødvendige API-formatet og modellen gjennom /models.

Ikke bruk /connect for denne konfigurasjonen. Feltene apiKey leses COMETAPI_KEY fra miljøet. En variabel som ikke er angitt, evalueres til en tom verdi i stedet for en lagret /connect API-nøkkel.

Velg og verifiser hver leverandør

Start OpenCode i prosjektet du vil at det skal ha tilgang til:

opencode

Kjør /models, og velg deretter en provider/model-oppføring. I de fire verifiserings kjøringene i denne veiledningen brukte hver modellrunde den valgte oppføringens samsvarende API-format. Ingen forespørselsfordeling på tvers av formater eller automatisk forhandling av API-format ble observert.For å verifisere Chat Completions fra kommandolinjen kjører du:

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

For å verifisere Responses fra kommandolinjen kjører du:

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

For å verifisere Anthropic Messages fra kommandolinjen kjører du:

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

For å verifisere Gemini generateContent fra kommandolinjen kjører du:

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

Feilsøking

OpenCode viser ikke en CometAPI-modell

Bekreft at konfigurasjonen er gyldig JSON. Hver egendefinerte oppføring må være i provider-objektet på øverste nivå, og hver modell-ID må være i det tilsvarende models-objektet. Start OpenCode på nytt, og åpne deretter /models igjen.

OpenCode rapporterer en API-nøkkel- eller autentiseringsfeil

Bekreft at COMETAPI_KEY er angitt i skallet som starter OpenCode. En ikke angitt {env:COMETAPI_KEY}-referanse blir en tom verdi. Åpne et nytt skall etter at du har endret en skallprofil.

En modell-ID er ikke tilgjengelig

Kontroller siden CometAPI Models, og erstatt modell- ID-en i den valgte leverandøroppføringen. Bekreft at modellen godtar det API-formatet til leverandøren.

Forespørsler bruker en feil sti

Behold baseURL på /v1 for Chat Completions, Responses og Messages. Bruk /v1beta for Gemini. Ikke inkluder en operasjonssti i baseURL.

Én leverandør fungerer, men en annen mislykkes

Bruk en modell-ID som godtar API-formatet til den valgte leverandøren. Ikke anta at én modell-ID godtar alle fire formatene.

Prosjektkonfigurasjonen endrer en global leverandør

OpenCode slår sammen global konfigurasjon og prosjektkonfigurasjon. Gi prosjekt- leverandør-ID-en et nytt navn, eller fjern verdier som er i konflikt, når du vil at den globale leverandøroppføringen skal forbli uendret.

OpenCode har mer tilgang enn forventet

OpenCode bruker tillatelsene til prosessen som startet det. Kjør OpenCode i en container eller sandbox når du trenger strengere tilgangsgrenser.

Oversikt

AI-kodeagenter

AI-agenter

AI-chatklienter

Oversettelse og språk

Automatiseringsplattformer

Observerbarhet og evaluering

AI-rammeverk

Forutsetninger

Forstå API-formatene

Forstå kjøretidstillatelser

Konfigurer OpenCode

Feilsøking

Relaterte ressurser

​Forutsetninger

​Forstå API-formatene

​Forstå kjøretidstillatelser

​Konfigurer OpenCode

​Feilsøking

​Relaterte ressurser

Forutsetninger

Forstå API-formatene

Forstå kjøretidstillatelser

Konfigurer OpenCode

Feilsøking

Relaterte ressurser