---
title: "OpenCode API: Add FreeTheAI as a Custom Provider"
description: "Use AI models in OpenCode with FreeTheAI. Store the key with /connect and add the provider to opencode.json with context limits."
url: https://freetheai.org/setup/opencode
language: en
updated: 2026-09-29
---

# OpenCode API: Add FreeTheAI as a Custom Provider

OpenCode adds FreeTheAI as a custom provider: the key goes in with /connect, the provider and models go in opencode.json.

## Settings

- npm: `@ai-sdk/openai-compatible`
- baseURL: `https://api.freetheai.org/v1`
- Provider ID: `freetheai`

## Steps

1. **Store your key.** In OpenCode run /connect, scroll to Other, enter freetheai as the provider ID, then paste your key.
2. **Add the provider.** Add this to ~/.config/opencode/opencode.json (or opencode.json in your project).

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "freetheai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeTheAI",
      "options": { "baseURL": "https://api.freetheai.org/v1" },
      "models": {
        "glm-5.3": { "name": "GLM 5.3", "limit": { "context": 200000, "output": 32000 } },
        "kimi-k3.1-pro": { "name": "Kimi K3", "limit": { "context": 200000, "output": 32000 } }
      }
    }
  }
}
```
3. **Pick the model.** Run /models and choose a FreeTheAI model.

## Tips

- The limit values let OpenCode track how much context is left. Keep them at or below the model's real limits on freetheai.org/models.

## Troubleshooting

**Where does OpenCode keep the FreeTheAI key?**

/connect stores it in OpenCode's credential store. You can also set options.apiKey to "{env:FREETHEAI_API_KEY}".

Checked: Checked against OpenCode's provider docs (custom provider) on 2026-09-29.