OpenCode

Wire OpenCode up to Gab AI as a custom OpenAI-compatible provider via opencode.json.

Prerequisites

• A Gab AI Plus subscription
• A Gab AI API key (gab.ai → Settings → API)
• OpenCode installed locally — see opencode.ai/docs

Configuration

OpenCode does not pick up OPENAI_BASE_URL or OPENAI_API_KEY for custom endpoints — you have to declare Gab AI as a provider in opencode.json (project-local) or ~/.config/opencode/opencode.json (global) using the @ai-sdk/openai-compatible package. Each model you want to use must be listed under models with its Gab AI slug as the key. OpenCode stores credentials separately from the config file (in ~/.local/share/opencode/auth.json). After saving the config above:

• Start opencode in your project
• Run /connect and pick "Gab AI" from the list
• Paste your Gab AI API key when prompted
• Run /models and pick the model you want to use

• Connecting your API key

opencode.json

Slug case sensitivity

The keys under models must exactly match slugs returned by GET /v1/models — they're lowercase, hyphenated, and use no dots. "Claude Opus 4.7", "claude opus", or "claude_opus" all return 400 invalid_model.

Discover Compatible Models

Tool/function calling is required for OpenCode's agent loop. List Gab AI's function-calling models with: Add any of those slugs to the models map in your opencode.json to make them selectable in /models.

List function-calling models

Supported Features

• OpenAI-compatible Chat Completions (/v1/chat/completions)
• Tool/function calling with tool_calls and role: tool messages
• Streaming with tool-call argument deltas
• Vision input on multimodal models (image_url with URL, base64, or file_id)
• Structured outputs (response_format: json_object / json_schema)

Troubleshooting

• 401 authentication_error: re-run /connect and re-paste your key.
• 400 invalid_model: the slug under "models" doesn’t match a real Gab AI slug. Verify against /v1/models.
• Tool calls misbehaving: confirm capabilities.function_calling is true for the model you picked.
• Custom provider options ignored: known OpenCode bug (sst/opencode#5674). Update OpenCode and re-test.
• Use https://gab.ai/v1 as the baseURL — not https://chat.gab.com or https://gab.ai (Anthropic-style clients use the bare host).

Still failing?

Capture the exact request body and response from OpenCode's debug output. Most setup issues come down to (a) a model slug typo, (b) a model without function calling, or (c) the custom-provider-options bug above.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gab-ai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Gab AI",
      "options": {
        "baseURL": "https://gab.ai/v1"
      },
      "models": {
        "arya":             { "name": "Arya" },
        "claude-opus-4-7":  { "name": "Claude Opus 4.7" },
        "claude-opus-4-8":  { "name": "Claude Opus 4.8" },
        "claude-sonnet-4-5":{ "name": "Claude Sonnet 4.5" },
        "gpt-5-5":          { "name": "GPT-5.5" },
        "gpt-5-3-codex":    { "name": "GPT-5.3 Codex" },
        "gemini-3-5-flash": { "name": "Gemini 3.5 Flash" },
        "qwen-3-5-397b":    { "name": "Qwen 3.5 397B" },
        "minimax-m2-7":     { "name": "MiniMax M2.7" }
      }
    }
  }
}

Slug case sensitivity

The keys under models must exactly match slugs returned by GET /v1/models — they're lowercase, hyphenated, and use no dots. "Claude Opus 4.7", "claude opus", or "claude_opus" all return 400 invalid_model.

curl https://gab.ai/v1/models \\
  -H "Authorization: Bearer YOUR_GAB_API_KEY" \\
  | jq -r '.data[] | select(.capabilities.function_calling and .capabilities.text) | .id'

Still failing?

Capture the exact request body and response from OpenCode's debug output. Most setup issues come down to (a) a model slug typo, (b) a model without function calling, or (c) the custom-provider-options bug above.

Last updated: 2026-06-18