Supported Providers
Every model provider Sophon supports, grouped by type, with provider ids and authentication.
Sophon is bring-your-own-key: it ships with no pre-configured providers. You add the ones you want, and each provider's credentials are encrypted at rest in models.json. The tables below list every provider Sophon supports.
The id in each row is the value you set as the provider type — both in models.json (the providerType field) and in the interactive sophon models add wizard. Use these exact ids.
The model lists each provider exposes — display names, capabilities, and per-token pricing in pickers and Settings — are backed by Sophon's bundled Model Catalog, which you can extend or override with your own entries.
Auth types come from the ProviderAuthType enum: ApiKey (Bearer token), CliSync (read tokens from an external CLI's credential store), OAuth (Sophon runs OAuth 2.1 + PKCE), and None (local, no credential).
Cloud LLM providers
API key unless the Notes column says otherwise.
| Provider | id | Auth | Notes |
|---|---|---|---|
| Anthropic (Claude) | anthropic | ApiKey | |
| OpenAI (GPT) | openai | ApiKey | |
| Google Gemini | gemini | ApiKey | |
| Azure OpenAI | azure-openai | ApiKey | Also needs a resource endpoint and a deployment name; optional api-version (defaults to a recent preview). |
| AWS Bedrock | bedrock | ApiKey | AWS access key id + secret access key + region (default us-east-1); signed with SigV4. Converse API. |
| Cloudflare Workers AI | cloudflare | ApiKey | Account id + API token. Account id is embedded in the base URL. |
| DeepSeek | deepseek | ApiKey | |
| Fireworks AI | fireworks | ApiKey | |
| Groq | groq | ApiKey | |
| Hugging Face Inference | huggingface | ApiKey | |
| MiniMax | minimax | ApiKey | |
| Mistral AI | mistral | ApiKey | |
| Moonshot AI (Kimi) | moonshot | ApiKey | |
| NVIDIA NIM | nvidia-nim | ApiKey | |
| OpenRouter | openrouter | ApiKey | Aggregator — reaches 100+ models behind one key. |
| Perplexity | perplexity | ApiKey | |
| Qwen (Alibaba Cloud) | qwen | ApiKey | |
| StepFun | stepfun | ApiKey | |
| Together AI | together | ApiKey | |
| xAI (Grok) | xai | ApiKey | |
| Zhipu AI (GLM) | zhipu | ApiKey | |
| Sophon Forge | sophon-forge | ApiKey | Sophon's hosted, OpenAI-compatible inference service — see Sophon Forge. |
Local / self-hosted
No auth — set a base URL (a sensible default is assumed if you omit it).
| Provider | id | Auth | Notes |
|---|---|---|---|
| Ollama | ollama | None | Base URL defaults to http://localhost:11434. Tool calling depends on the model. |
| LM Studio | lmstudio | None | Point at your local LM Studio server's OpenAI-compatible base URL. |
OpenAI-compatible
For any endpoint that speaks the OpenAI Chat Completions format.
| Provider | id | Auth | Notes |
|---|---|---|---|
| Custom (OpenAI-compatible) | custom-openai | ApiKey | Requires a base endpoint; API key is optional. Works with LiteLLM, vLLM, proxies, and self-hosted gateways. |
Subscription / CLI sign-in
These reuse an existing subscription instead of a metered API key. Per-token cost is reported as $0 because billing is flat-rate. See Subscription & CLI Sign-In for the sign-in flow.
| Provider | id | Auth | Notes |
|---|---|---|---|
| Anthropic via Claude Pro/Max | anthropic-subscription | CliSync | Calls the Anthropic API directly as Claude Code using the CLI's stored token. Non-tool chat on a plain subscription — tool-bearing requests hit the overage lane with an actionable error. Sign in with claude auth login. |
| Claude Code CLI | claude-code | CliSync | Shells the claude CLI (claude -p). Text-only — no tool calling; normal subscription limits, no overage. |
| Claude Code agent | claude-code-agent | CliSync | Runs claude -p as its own agent loop, exposed as a normal provider. Tool-using and overage-free — drives Sophon tools over the embedded MCP server; approval/risk/sandbox gates still apply. |
| OpenAI Codex (ChatGPT) | openai-codex | OAuth | Codex CLI / OAuth against a ChatGPT subscription. Flat-rate. |
| GitHub Copilot | github-copilot | OAuth | Device-flow sign-in; exchanges for a Copilot token. Flat-rate. |
models.json example
A single configured provider looks like this. sophon models add writes the same structure for you (and encrypts the key):
{
"providers": [
{
"id": "anthropic-primary",
"name": "Anthropic",
"providerType": "anthropic",
"apiKey": "sk-ant-...",
"priority": 1,
"isDefault": true,
"models": [
{ "id": "claude-sonnet-4-5", "isDefault": true }
]
}
]
}priority orders providers for routing and failover; lower numbers are tried first. Combine multiple providers, set per-provider budgets, and control fallback in Routing, Failover & Budgets.
Reaching a provider that isn't listed
If a model isn't covered by a native provider above, two ids fill the gap:
openrouter— one API key fronts 100+ hosted models across many vendors.custom-openai— point at any OpenAI-compatible base URL (self-hosted, a proxy, or a new vendor) with an optional key.
Related
- Subscription & CLI Sign-In — use Claude Pro/Max, ChatGPT, or Copilot instead of an API key.
- Routing, Failover & Budgets — priority, fallback, and spend limits across providers.
- Configuration — add your first provider via the Dashboard or CLI.