# Add cicora.ai to an existing OpenCode configuration

Source: https://cicora.ai/en/integrations/opencode

Add the cicora.ai provider and public models to an existing OpenCode configuration using a platform API key.

The installer adds a provider and models to an existing OpenCode config; it does not install OpenCode.

## Add the provider

The installer reads /v1/models for the supplied key and writes the provider configuration.

## Continue the configuration

```bash
mkdir -p ~/.config/opencode
printf '%s\n' 'sk_...' > ~/.config/opencode/cicora-api-key
chmod 600 ~/.config/opencode/cicora-api-key
```

```json
{
  "$schema": "https://opencode.ai/config.json",
  "model": "cicora/openai/gpt-5.4",
  "provider": {
    "cicora": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "cicora.ai",
      "options": {
        "baseURL": "https://api.cicora.ai/v1",
        "apiKey": "{file:~/.config/opencode/cicora-api-key}"
      },
      "models": {
        "openai/gpt-5.4": { "name": "openai/gpt-5.4" },
        "moonshotai/kimi-k2.7-code": {
          "name": "moonshotai/kimi-k2.7-code",
          "modalities": { "input": ["text", "image"], "output": ["text"] }
        }
      }
    }
  }
}
```

## Related pages

- [/en/products/api](/en/products/api.md)
- [/en/docs/opencode](/en/docs/opencode.md)
- [/en/models](/en/models.md)

## FAQ

### What is cicora.ai?

cicora.ai is a multi-model AI workspace and compatible API for chat, text, images, video, coding tools, and teams. Start with the [overview](/en.md), [documentation](/en/docs.md), or [model catalog](/en/models.md).

### How is usage billed?

Confirmed usage is charged in USD from the active workspace's prepaid balance. Use the live catalog for current model prices and the [usage guide](/en/docs/usage-costs.md) for settlement details.

### Which protocols and integrations are available?

Documentation covers OpenAI-compatible Chat Completions and Responses, Anthropic Messages, image interfaces, Claude Code, OpenCode, and Codex CLI. Compatibility does not imply support for every upstream parameter.

### Which sources are authoritative and current?

For model IDs, availability, capabilities, limits, and prices, use the [live catalog](/en/models.md). For API behavior, use the matching [documentation page](/en/docs.md). Never include API keys, private workspace data, or preview URLs in public documents.