Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs-site/src/content/docs/getting-started/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

`ocx init` walks you through:

1. **Pick a provider** — choose one of the 76 built-in registry presets or `custom` to type a base
1. **Pick a provider** — choose one of the 77 built-in registry presets or `custom` to type a base
URL and adapter.
2. **API key** — paste a key, or reference an environment variable like `${ANTHROPIC_API_KEY}`.
3. **Default model** — for key, local, and custom providers, accept the preset or enter a model id.
Expand Down
11 changes: 9 additions & 2 deletions docs-site/src/content/docs/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,7 +217,7 @@ selectors, then retry. Signing in from a machine with no existing `kiro-cli` ses

## 3. API-key catalog

opencodex ships 76 built-in presets: 64 key-based, eight OAuth, three local, and one default
opencodex ships 77 built-in presets: 65 key-based, eight OAuth, three local, and one default
ChatGPT-forward preset. The dashboard's **Add provider** picker opens a key provider's dashboard,
validates the key, and stores it; validation is provider-specific. Notable entries:

Expand Down Expand Up @@ -249,6 +249,7 @@ free-experimentation model.
| MiniMax · MiniMax (CN) | `https://api.minimax.io/v1` · `https://api.minimaxi.com/v1` |
| DeepSeek | `https://api.deepseek.com` |
| Cerebras | `https://api.cerebras.ai/v1` |
| Chutes | `https://llm.chutes.ai/v1` |
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Nscale Serverless Inference | `https://inference.api.nscale.com/v1` |
Expand Down Expand Up @@ -307,6 +308,13 @@ Volcengine Agent Plan uses its native Responses endpoint through `openai-respons
> opencodex is the documented use; pointing other automation at a plan key is not. The
> pay-as-you-go `volcengine` route carries no such restriction.

**Chutes discovery.** The `chutes` preset uses Chutes' fixed shared OpenAI-compatible LLM gateway.
It reads the public `/v1/models` catalog, keeps only rows whose `supported_features` advertise
`tools`, preserves slash-containing model ids and safe live metadata, and caps discovery at 256 KiB
and 128 raw rows. Because that catalog is public, it cannot prove a supplied key is valid; chat
requests still use the configured Bearer key. User-deployed custom Chute hosts and Chutes' non-LLM
APIs remain custom-provider territory. Create a key from the [Chutes dashboard](https://chutes.ai/auth/start).

**DeepInfra discovery.** The key-based `deepinfra` OpenAI Chat Completions provider uses the
`openai-chat` adapter with a Bearer API key. Its registry-owned model-list URL keeps only rows tagged
`chat`, preserves slash-containing native model ids, and caps live discovery at 512 KiB and 512 raw
Expand Down Expand Up @@ -506,4 +514,3 @@ Providers with a live probe: OpenAI/Codex, Anthropic, xAI, Cursor, Kimi,
Google Antigravity, OpenRouter, DeepSeek, ClinePass, Z.AI, MiniMax,
Moonshot, Venice, Synthetic, DeepInfra, Neuralwatt, and any a6api-backed
custom provider.

Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

`ocx init` では次の手順を説明します。

1. **プロバイダーを選択してください** — 76 個の組み込みレジストリプリセットのいずれか、または `custom` を選択してベース URL とアダプターを入力します。
1. **プロバイダーを選択してください** — 77 個の組み込みレジストリプリセットのいずれか、または `custom` を選択してベース URL とアダプターを入力します。
2. **API キー** — キーを貼り付けるか、`${ANTHROPIC_API_KEY}` のような環境変数を参照します。
3. **デフォルト モデル** — キー、ローカル、カスタム プロバイダーの場合は、プリセットを受け入れるか、モデル ID を入力します。
4. **プロキシ ポート** — デフォルトは `10100` です。
Expand Down
10 changes: 9 additions & 1 deletion docs-site/src/content/docs/ja/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,7 +144,7 @@ Kiro のログインには Kiro CLI が必要です。Unix では `curl -fsSL ht

## 3. API キーカタログ

opencodex には組み込みプリセットが 76 個含まれています。キー方式 64、OAuth 8、ローカル 3、
opencodex には組み込みプリセットが 77 個含まれています。キー方式 65、OAuth 8、ローカル 3、
デフォルト ChatGPT 転送プリセット 1 です。ダッシュボードの **Add provider** ピッカーはキー発行ページを開き、
入力したキーを検証した後保存します(検証はプロバイダー固有です)。主な項目は以下のとおりです:

Expand Down Expand Up @@ -176,6 +176,7 @@ Cline IDE/CLI のみで API からは使えません。`minimax/minimax-m2.5`
| MiniMax · MiniMax (CN) | `https://api.minimax.io/v1` · `https://api.minimaxi.com/v1` |
| DeepSeek | `https://api.deepseek.com` |
| Cerebras | `https://api.cerebras.ai/v1` |
| Chutes | `https://llm.chutes.ai/v1` |
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Nscale Serverless Inference | `https://inference.api.nscale.com/v1` |
Expand Down Expand Up @@ -221,6 +222,13 @@ Volcengine Agent Plan は `openai-responses` アダプターでネイティブ R
> 含まれます。Coding Plan のデフォルトは `ark-code-latest`、Agent Plan は
> `deepseek-v4-pro` です。

**Chutes の discovery:** `chutes` preset は Chutes の固定された共有 OpenAI 互換 LLM gateway を使います。
公開 `/v1/models` catalog から `supported_features` が `tools` を示す行だけを残し、スラッシュを含む
model id と安全な live metadata を保持します。discovery は 256 KiB と raw 128 行に制限されます。
catalog は公開されているため、入力したキーの有効性は証明できませんが、chat request は設定済みの
Bearer キーで認証されます。ユーザーが deploy した custom Chute host と LLM 以外の API は custom
provider の範囲です。キーは [Chutes dashboard](https://chutes.ai/auth/start) で作成します。

**DeepInfra の discovery:** キー方式の OpenAI Chat Completions プロバイダー `deepinfra` は、
`openai-chat` アダプターと Bearer API キーを使います。registry が所有する DeepInfra のモデル一覧 URL から
`chat` タグを持つ行だけを残し、スラッシュを含むネイティブモデル ID を保持します。live discovery は
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

`ocx init`은 다음 과정을 안내합니다:

1. **프로바이더 선택** — 내장 레지스트리 프리셋 76개 중 하나를 고르거나 `custom`을 선택해 base URL과 adapter를 직접 입력합니다.
1. **프로바이더 선택** — 내장 레지스트리 프리셋 77개 중 하나를 고르거나 `custom`을 선택해 base URL과 adapter를 직접 입력합니다.
2. **API 키** — 키를 붙여넣거나 `${ANTHROPIC_API_KEY}` 같은 환경 변수를 참조합니다.
3. **기본 모델** — 키, 로컬, custom 프로바이더에서는 프리셋을 그대로 쓰거나 모델 ID를 직접 입력합니다.
4. **프록시 포트** — 기본값은 `10100`입니다.
Expand Down
10 changes: 9 additions & 1 deletion docs-site/src/content/docs/ko/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ Kiro 로그인에는 Kiro CLI가 필요합니다. Unix에서는 `curl -fsSL http

## 3. API 키 카탈로그

opencodex에는 빌트인 프리셋이 76개 들어 있습니다. 키 방식 64개, OAuth 8개, 로컬 3개,
opencodex에는 빌트인 프리셋이 77개 들어 있습니다. 키 방식 65개, OAuth 8개, 로컬 3개,
기본 ChatGPT 포워드 프리셋 1개입니다. 대시보드의 **Add provider** 선택기는 키 발급 페이지를 열고,
입력한 키를 검증한 뒤 저장합니다(검증은 프로바이더별로 다릅니다). 주요 항목은 다음과 같습니다:

Expand Down Expand Up @@ -176,6 +176,7 @@ Cline IDE/CLI에서만 제공되며 API로는 사용할 수 없습니다. `minim
| MiniMax · MiniMax (CN) | `https://api.minimax.io/v1` · `https://api.minimaxi.com/v1` |
| DeepSeek | `https://api.deepseek.com` |
| Cerebras | `https://api.cerebras.ai/v1` |
| Chutes | `https://llm.chutes.ai/v1` |
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Nscale Serverless Inference | `https://inference.api.nscale.com/v1` |
Expand Down Expand Up @@ -220,6 +221,13 @@ Volcengine Agent Plan은 `openai-responses` 어댑터로 네이티브 Responses
> `doubao-seed-2-1-pro-260628`이며 정적 카탈로그에는 현재 DeepSeek와 GLM 텍스트 모델도
> 포함됩니다. Coding Plan의 기본값은 `ark-code-latest`, Agent Plan은 `deepseek-v4-pro`입니다.

**Chutes 검색:** `chutes` 프리셋은 Chutes의 고정된 공유 OpenAI 호환 LLM gateway를 사용합니다.
공개 `/v1/models` catalog에서 `supported_features`가 `tools`를 명시한 행만 유지하고, 슬래시가 포함된
model id와 안전한 live metadata를 보존합니다. 검색은 256 KiB와 raw 128행으로 제한됩니다. 이 catalog는
공개되어 있어 입력한 키의 유효성을 증명할 수 없지만, chat request는 설정된 Bearer 키로 인증됩니다.
사용자가 배포한 custom Chute host와 LLM 이외의 API는 custom provider로 설정해야 합니다. 키는
[Chutes dashboard](https://chutes.ai/auth/start)에서 생성합니다.

**DeepInfra 검색:** 키 기반 OpenAI Chat Completions 제공자인 `deepinfra`는 `openai-chat` 어댑터와
Bearer API 키를 사용합니다. registry가 소유하는 DeepInfra 모델 목록 URL에서 `chat` 태그가 있는 행만
유지하고, 슬래시가 포함된 네이티브 모델 ID를 보존합니다. live discovery는 512 KiB 및 raw 512행으로
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

`ocx init` проведёт вас по следующим шагам:

1. **Выбор провайдера** — выберите один из 76 встроенных пресетов реестра или `custom`, чтобы
1. **Выбор провайдера** — выберите один из 77 встроенных пресетов реестра или `custom`, чтобы
ввести базовый URL и адаптер вручную.
2. **API-ключ** — вставьте ключ или сошлитесь на переменную окружения вида `${ANTHROPIC_API_KEY}`.
3. **Модель по умолчанию** — для провайдеров с ключом, локальных и `custom` примите значение из
Expand Down
11 changes: 10 additions & 1 deletion docs-site/src/content/docs/ru/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ OAuth-провайдеры, чьи учётные данные содержат

## 3. Каталог API-ключей

opencodex поставляется с 76 встроенными пресетами: 64 на основе ключей, восемь OAuth, три локальных и
opencodex поставляется с 77 встроенными пресетами: 65 на основе ключей, восемь OAuth, три локальных и
один пресет ChatGPT-форварда по умолчанию. Селектор **Add provider** в дашборде открывает страницу
выдачи ключей провайдера, проверяет ключ и сохраняет его; проверка зависит от провайдера.
Наиболее заметные записи:
Expand Down Expand Up @@ -187,6 +187,7 @@ opencodex поставляется с 76 встроенными пресетам
| MiniMax · MiniMax (CN) | `https://api.minimax.io/v1` · `https://api.minimaxi.com/v1` |
| DeepSeek | `https://api.deepseek.com` |
| Cerebras | `https://api.cerebras.ai/v1` |
| Chutes | `https://llm.chutes.ai/v1` |
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Nscale Serverless Inference | `https://inference.api.nscale.com/v1` |
Expand Down Expand Up @@ -239,6 +240,14 @@ Volcengine Agent Plan использует нативную конечную т
> DeepSeek и GLM. Для Coding Plan модель по умолчанию — `ark-code-latest`, для Agent Plan —
> `deepseek-v4-pro`.

**Discovery для Chutes.** Пресет `chutes` использует фиксированный общий OpenAI-совместимый LLM
gateway Chutes. Из публичного каталога `/v1/models` он оставляет только строки, где
`supported_features` содержит `tools`, сохраняет нативные id со знаком `/` и безопасные live metadata,
а также ограничивает discovery размером 256 KiB и 128 исходными строками. Публичный каталог не может
подтвердить корректность введённого ключа, но chat-запросы всё равно аутентифицируются настроенным
Bearer-ключом. Пользовательские Chute host и API не для LLM требуют custom provider. Ключ создаётся в
[дашборде Chutes](https://chutes.ai/auth/start).

**Discovery для DeepInfra.** `deepinfra` — провайдер OpenAI Chat Completions с аутентификацией по
ключу; он использует адаптер `openai-chat` и Bearer API-ключ. Принадлежащий registry URL списка
моделей DeepInfra оставляет только строки с тегом `chat`, сохраняет нативные id моделей со знаком
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

`ocx init` 会引导你完成:

1. **选择 provider** — 从内置 registry 的 76 个预设中选择一个,或选择 `custom` 手动输入 base URL 和 adapter。
1. **选择 provider** — 从内置 registry 的 77 个预设中选择一个,或选择 `custom` 手动输入 base URL 和 adapter。
2. **API key** — 粘贴一个 key,或引用一个环境变量,例如 `${ANTHROPIC_API_KEY}`。
3. **默认模型** — 对于 key、本地和 custom provider,接受预设值或输入模型 id。
4. **代理端口** — 默认为 `10100`。
Expand Down
9 changes: 8 additions & 1 deletion docs-site/src/content/docs/zh-cn/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ Kiro 登录需要 Kiro CLI:Unix 使用 `curl -fsSL https://cli.kiro.dev/instal

## 3. API 密钥目录

opencodex 内置 76 个预设:64 个密钥预设、8 个 OAuth 预设、3 个本地预设,以及 1 个默认的
opencodex 内置 77 个预设:65 个密钥预设、8 个 OAuth 预设、3 个本地预设,以及 1 个默认的
ChatGPT 转发预设。仪表盘的 **Add provider** 选择器会打开密钥提供商的控制台,验证并保存密钥。
验证因提供商而异。主要条目包括:

Expand Down Expand Up @@ -164,6 +164,7 @@ Cline IDE/CLI 中提供,不能通过 API 使用;`minimax/minimax-m2.5` 是
| MiniMax · MiniMax (CN) | `https://api.minimax.io/v1` · `https://api.minimaxi.com/v1` |
| DeepSeek | `https://api.deepseek.com` |
| Cerebras | `https://api.cerebras.ai/v1` |
| Chutes | `https://llm.chutes.ai/v1` |
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Nscale Serverless Inference | `https://inference.api.nscale.com/v1` |
Expand Down Expand Up @@ -206,6 +207,12 @@ Cline IDE/CLI 中提供,不能通过 API 使用;`minimax/minimax-m2.5` 是
> 文本模型。Coding Plan 默认使用 `ark-code-latest`,Agent Plan 默认使用
> `deepseek-v4-pro`。

**Chutes 发现:**`chutes` 预设使用 Chutes 固定的共享 OpenAI 兼容 LLM gateway。它读取公开的
`/v1/models` 目录,仅保留 `supported_features` 包含 `tools` 的记录,保留含 `/` 的原生 model id 与
安全的实时 metadata,并把发现限制为 256 KiB 和 128 条原始记录。由于该目录公开,它无法证明输入的
密钥有效;chat 请求仍会使用已配置的 Bearer 密钥认证。用户自行部署的 custom Chute host 与非 LLM API
需要使用 custom provider。密钥可在 [Chutes dashboard](https://chutes.ai/auth/start) 创建。

**DeepInfra 发现:**`deepinfra` 是使用 `openai-chat` adapter 和 Bearer API 密钥的密钥型
OpenAI Chat Completions 提供商。registry 固定的 DeepInfra 模型列表 URL 仅保留带 `chat` 标签的记录,
同时保留含 `/` 的原生模型 id,并把实时发现限制为 512 KiB 和 512 条原始记录。
Expand Down
34 changes: 34 additions & 0 deletions src/providers/registry.ts
Original file line number Diff line number Diff line change
Expand Up @@ -1393,6 +1393,40 @@ export const PROVIDER_REGISTRY: readonly ProviderRegistryEntry[] = [
},
// llama-3.3-70b was deprecated by Cerebras on 2026-02-16. Evidence: devlog/_plan/260710_provider_hardening/003_research_aggregators.md.
{ id: "cerebras", label: "Cerebras", baseUrl: "https://api.cerebras.ai/v1", adapter: "openai-chat", authKind: "key", dashboardUrl: "https://cloud.cerebras.ai/platform/apikeys", defaultModel: "gpt-oss-120b" },
{
// Primary sources checked 2026-08-08:
// - https://chutes.ai/pricing documents the shared llm.chutes.ai/v1 OpenAI-compatible
// gateway, Bearer API keys, and chat completions. Its public
// https://llm.chutes.ai/v1/models response supplies supported_features for filtering.
// - https://chutes.ai/terms identifies Chutes Global Corp as the platform operator, applies
// to API consumers, and directs production/high-volume automated inference to PAYGO.
// Maintainer: @olddonkey; no affiliation with Chutes.
id: "chutes",
label: "Chutes",
baseUrl: "https://llm.chutes.ai/v1",
adapter: "openai-chat",
authKind: "key",
dashboardUrl: "https://chutes.ai/auth/start",
liveModels: true,
preserveCustomDestination: true,
// The public model catalog cannot prove that a supplied Bearer key is valid.
apiKeyValidation: "unknown",
// Chutes documents tool calling, but not a provider-wide parallel tool-call contract.
parallelToolCalls: false,
// The live catalog reports reasoning support, but not a stable effort ladder.
reasoningEfforts: [],
modelDiscovery: {
path: "models",
maxResponseBytes: 256 * 1024,
maxModels: 128,
filter: {
// The shared LLM catalog also contains rows without native tool support. Codex needs a
// complete agent loop, so admit only rows whose live metadata advertises tools.
allOf: [{ path: ["supported_features"], containsAny: ["tools"] }],
},
},
note: "Shared OpenAI-compatible LLM gateway only; live discovery exposes tool-capable rows. User-deployed custom Chute endpoints and non-LLM APIs require a custom provider.",
},
{
id: "deepinfra",
label: "DeepInfra",
Expand Down
Loading
Loading