OpenCode

Create an API key

Sign in with your Base wallet at /keys and mint a Gondola API key. Keys start with gnd_. It authenticates every request and each call is charged in USDC against your Gondola balance.

Top up USDC on Base once at /wallet. The same balance powers the browser chat and every tool you connect.

Point OpenCode at Gondola

Add a Gondola provider to your OpenCode config: either the global ~/.config/opencode/opencode.json or a repo-root opencode.json (settings merge key by key). Use the OpenAI-compatible provider package and read the key from an environment variable:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gondola": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Gondola",
      "options": {
        "baseURL": "https://api.gondola-ai.com/v1",
        "apiKey": "{env:GONDOLA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "limit": { "context": 200000, "output": 64000 }
        }
      }
    }
  },
  "model": "gondola/claude-sonnet-5"
}

Export the key and launch OpenCode on a Gondola model:

export GONDOLA_API_KEY=gnd_live_xxxx
opencode -m gondola/claude-sonnet-5

Pick a model

Gondola serves the full Venice catalog. Each model needs its own entry under models keyed by the exact id, and you reference it as gondola/<id>. Pull the live list:

curl https://api.gondola-ai.com/v1/models

Each entry includes context_length and max_completion_tokens. Copy those into limit.context and limit.output so OpenCode budgets the conversation correctly.

Notes and troubleshooting

If the TUI model picker does not list your custom models, select them with the -m gondola/<id> flag (or the /model command) instead. If a request returns insufficient balance, top up at /wallet.