Skip to content
Open
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 66 built-in registry presets or `custom` to type a base
1. **Pick a provider** — choose one of the 68 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
16 changes: 15 additions & 1 deletion docs-site/src/content/docs/guides/providers.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,7 @@ selectors, then retry. Signing in from a machine with no existing `kiro-cli` ses

## 3. API-key catalog

opencodex ships 66 built-in presets: 55 key-based, seven OAuth, three local, and the default
opencodex ships 68 built-in presets: 57 key-based, seven OAuth, three local, and the default
ChatGPT-forward preset. The dashboard's **Add provider** picker opens a key provider's dashboard,
validates the key, and stores it. Notable entries:

Expand All @@ -210,6 +210,8 @@ validates the key, and stores it. Notable entries:
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Baseten Model APIs | `https://inference.baseten.co/v1` |
| DigitalOcean Serverless Inference | `https://inference.do-ai.run/v1` |
| Scaleway Generative APIs | `https://api.scaleway.ai/v1` |
| Together | `https://api.together.xyz/v1` |
| Fireworks | `https://api.fireworks.ai/inference/v1` |
| Moonshot (Kimi API) · Kimi (coding) | `https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1` |
Expand Down Expand Up @@ -258,6 +260,18 @@ slash-containing native model ids, and caps live discovery at 256 KiB and 256 ra
serverless text and vision-language chat only; Hyperbolic's separate image, audio, and GPU endpoints
are out of scope. Create keys at [Hyperbolic](https://app.hyperbolic.ai).

**DigitalOcean discovery.** The preset uses a model access key against the fixed shared Serverless
Inference host and intersects the authenticated `/v1/models` response with DigitalOcean's
docs-backed Chat Completions allowlist. Unknown, Responses-only, embedding, and media-generation
ids fail closed. Discovery is capped at 256 KiB and 256 raw rows; agent-specific and dedicated
hosts are out of scope. Create a key in the [DigitalOcean Control Panel](https://cloud.digitalocean.com/model-studio/manage-keys).

**Scaleway discovery.** The preset intersects the authenticated model list with Scaleway's current
Serverless chat-model allowlist, excluding embeddings and audio transcription, and caps discovery
at 128 KiB and 128 raw rows. It uses the default Project's shared endpoint; project-qualified URLs
and dedicated deployments require a custom provider. Create an API key in the
[Scaleway console](https://console.scaleway.com/generative-api).
Comment on lines +269 to +273

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Complete the Scaleway discovery contract in every locale.

These sections describe a chat-model allowlist but do not explicitly identify the documented Chat Completions allowlist or fail-closed exclusion of unknown, Responses-only, and other media models. The Korean section also omits the custom-provider requirement for Project-qualified URLs and dedicated deployments.

  • docs-site/src/content/docs/guides/providers.md#L269-L273: State the documented Chat Completions allowlist and explicit fail-closed exclusions.
  • docs-site/src/content/docs/ja/guides/providers.md#L192-L195: State the documented Chat Completions allowlist and explicit fail-closed exclusions.
  • docs-site/src/content/docs/ko/guides/providers.md#L191-L194: Add the documented Chat Completions and fail-closed exclusions, and state that Project-qualified URLs and dedicated deployments require a custom provider.
  • docs-site/src/content/docs/ru/guides/providers.md#L202-L206: State the documented Chat Completions allowlist and explicit fail-closed exclusions.
  • docs-site/src/content/docs/zh-cn/guides/providers.md#L180-L183: State the documented Chat Completions allowlist and explicit fail-closed exclusions.

As per path instructions, localized provider catalogs must stay synchronized and document authenticated allowlist intersection, bounded discovery, fail-closed exclusions, and provider-specific endpoint scope.

📍 Affects 5 files
  • docs-site/src/content/docs/guides/providers.md#L269-L273 (this comment)
  • docs-site/src/content/docs/ja/guides/providers.md#L192-L195
  • docs-site/src/content/docs/ko/guides/providers.md#L191-L194
  • docs-site/src/content/docs/ru/guides/providers.md#L202-L206
  • docs-site/src/content/docs/zh-cn/guides/providers.md#L180-L183
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs-site/src/content/docs/guides/providers.md` around lines 269 - 273,
Synchronize the Scaleway discovery sections in
docs-site/src/content/docs/guides/providers.md:269-273,
docs-site/src/content/docs/ja/guides/providers.md:192-195,
docs-site/src/content/docs/ko/guides/providers.md:191-194,
docs-site/src/content/docs/ru/guides/providers.md:202-206, and
docs-site/src/content/docs/zh-cn/guides/providers.md:180-183. In each locale,
identify the documented Chat Completions allowlist, authenticated-model
intersection, bounded discovery, and fail-closed exclusion of unknown,
Responses-only, embeddings, transcription, and other media models; additionally
update the Korean section to state that Project-qualified URLs and dedicated
deployments require a custom provider.

Source: Path instructions


> **Baseten scope:** The preset covers Baseten's shared [Model APIs](https://docs.baseten.co/inference/model-apis/overview)
> only. Use a personal [API key](https://docs.baseten.co/organization/api-keys) for local use, or a team key
> with **Call Model APIs** access for shared/production use. Dedicated Truss `predict` endpoints use different
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

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

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

## 3. API キーカタログ

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

Expand All @@ -139,6 +139,8 @@ opencodex には組み込みプリセットが 66 個含まれています。キ
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Baseten Model APIs | `https://inference.baseten.co/v1` |
| DigitalOcean Serverless Inference | `https://inference.do-ai.run/v1` |
| Scaleway Generative APIs | `https://api.scaleway.ai/v1` |
| Together | `https://api.together.xyz/v1` |
| Fireworks | `https://api.fireworks.ai/inference/v1` |
| Moonshot (Kimi API) · Kimi (coding) | `https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1` |
Expand Down Expand Up @@ -181,6 +183,17 @@ Volcengine Agent Plan は `openai-responses` アダプターでネイティブ R
vision-language chat のみを対象とし、別系統の image、audio、GPU endpoint は対象外です。キーは
[Hyperbolic](https://app.hyperbolic.ai) で作成します。

**DigitalOcean の discovery:** preset は model access key を固定の共有 Serverless Inference ホストで使い、
認証済み `/v1/models` の応答と DigitalOcean の公式ドキュメントで確認した Chat Completions allowlist の
積集合だけを公開します。未知、Responses 専用、embedding、media generation の id は fail closed で除外し、
discovery を 256 KiB と raw 256 行に制限します。agent 固有 host と dedicated host は対象外です。キーは
[DigitalOcean Control Panel](https://cloud.digitalocean.com/model-studio/manage-keys) で作成します。

**Scaleway の discovery:** 認証済みモデル一覧と現在の Serverless chat-model allowlist の積集合だけを
公開し、embedding と audio transcription を除外して、discovery を 128 KiB と raw 128 行に制限します。
default Project の共有 endpoint を使用します。Project id 付き URL と dedicated deployment は custom
provider で設定してください。API キーは [Scaleway console](https://console.scaleway.com/generative-api) で作成します。

> **Baseten の対象範囲:** このプリセットは Baseten の共有 [Model APIs](https://docs.baseten.co/inference/model-apis/overview)
> のみを対象とします。ローカル利用では個人の [API キー](https://docs.baseten.co/organization/api-keys)を、
> 共有/本番利用では **Call Model APIs** 権限を持つチームキーを使用してください。専用 Truss `predict`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

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

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

## 3. API 키 카탈로그

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

Expand All @@ -139,6 +139,8 @@ opencodex에는 빌트인 프리셋이 66개 들어 있습니다. 키 방식 55
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Baseten Model APIs | `https://inference.baseten.co/v1` |
| DigitalOcean Serverless Inference | `https://inference.do-ai.run/v1` |
| Scaleway Generative APIs | `https://api.scaleway.ai/v1` |
| Together | `https://api.together.xyz/v1` |
| Fireworks | `https://api.fireworks.ai/inference/v1` |
| Moonshot (Kimi API) · Kimi (coding) | `https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1` |
Expand Down Expand Up @@ -180,6 +182,17 @@ Bearer API 키를 사용합니다. registry가 소유하는 DeepInfra 모델 목
대상으로 하며 별도 image, audio, GPU 엔드포인트는 범위에서 제외합니다. 키는
[Hyperbolic](https://app.hyperbolic.ai)에서 생성합니다.

**DigitalOcean 검색:** 프리셋은 model access key를 고정된 공유 Serverless Inference 호스트에 사용하고,
인증된 `/v1/models` 응답과 DigitalOcean 공식 문서로 확인한 Chat Completions allowlist의 교집합만
노출합니다. 알 수 없는 ID, Responses 전용, embedding 및 media-generation ID는 fail closed로 제외하며,
discovery를 256 KiB와 raw 행 256개로 제한합니다. agent 전용 및 dedicated 호스트는 범위에서 제외합니다.
키는 [DigitalOcean Control Panel](https://cloud.digitalocean.com/model-studio/manage-keys)에서 생성합니다.

**Scaleway 검색:** 인증된 모델 목록과 현재 Serverless chat-model allowlist의 교집합만 노출하여 embedding과
audio transcription을 제외하고, discovery를 128 KiB와 raw 행 128개로 제한합니다. 기본 Project의 공유
endpoint를 사용합니다. Project ID가 포함된 URL과 dedicated deployment는 custom provider로 설정하세요.
API 키는 [Scaleway console](https://console.scaleway.com/generative-api)에서 생성합니다.

> **Baseten 범위:** 이 프리셋은 Baseten의 공유 [Model APIs](https://docs.baseten.co/inference/model-apis/overview)만
> 지원합니다. 로컬 사용에는 개인 [API 키](https://docs.baseten.co/organization/api-keys)를, 공유/프로덕션
> 사용에는 **Call Model APIs** 권한이 있는 팀 키를 사용하세요. 전용 Truss `predict` 엔드포인트는
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ocx init

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

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

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

opencodex поставляется с 66 встроенными пресетами: 55 на основе ключей, семь OAuth, три локальных и
opencodex поставляется с 68 встроенными пресетами: 57 на основе ключей, семь OAuth, три локальных и
пресет ChatGPT-форварда по умолчанию. Селектор **Add provider** в дашборде открывает страницу
выдачи ключей провайдера, проверяет ключ и сохраняет его. Наиболее заметные записи:

Expand All @@ -146,6 +146,8 @@ opencodex поставляется с 66 встроенными пресетам
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Baseten Model APIs | `https://inference.baseten.co/v1` |
| DigitalOcean Serverless Inference | `https://inference.do-ai.run/v1` |
| Scaleway Generative APIs | `https://api.scaleway.ai/v1` |
| Together | `https://api.together.xyz/v1` |
| Fireworks | `https://api.fireworks.ai/inference/v1` |
| Moonshot (Kimi API) · Kimi (coding) | `https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1` |
Expand Down Expand Up @@ -190,6 +192,19 @@ Volcengine Agent Plan использует нативную конечную т
строками. Он охватывает только serverless text и vision-language chat; отдельные image, audio и GPU
endpoint в него не входят. Ключи создаются в [Hyperbolic](https://app.hyperbolic.ai).

**Discovery для DigitalOcean.** Пресет использует model access key на фиксированном общем хосте
Serverless Inference и публикует только пересечение аутентифицированного ответа `/v1/models` с
подтверждённым документацией allowlist для Chat Completions. Неизвестные, Responses-only,
embedding- и media-generation id исключаются по принципу fail closed. Discovery ограничен 256 KiB
и 256 исходными строками; agent-specific и dedicated хосты не входят в область пресета. Ключи
создаются в [DigitalOcean Control Panel](https://cloud.digitalocean.com/model-studio/manage-keys).

**Discovery для Scaleway.** Пресет публикует пересечение аутентифицированного списка моделей с
текущим allowlist serverless chat-моделей Scaleway, исключая embedding и audio transcription, и
ограничивает discovery размером 128 KiB и 128 исходными строками. Используется общий endpoint
Project по умолчанию; URL с Project ID и dedicated deployment настраиваются как custom provider.
API-ключ создаётся в [консоли Scaleway](https://console.scaleway.com/generative-api).

> **Область Baseten:** пресет поддерживает только общие [Model APIs](https://docs.baseten.co/inference/model-apis/overview)
> Baseten. Для локальной работы используйте личный [API-ключ](https://docs.baseten.co/organization/api-keys),
> а для общего/промышленного использования — командный ключ с правом **Call Model APIs**. Выделенные конечные точки Truss `predict` используют другие хосты и
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 的 66 个预设中选择一个,或选择 `custom` 手动输入 base URL 和 adapter。
1. **选择 provider** — 从内置 registry 的 68 个预设中选择一个,或选择 `custom` 手动输入 base URL 和 adapter。
2. **API key** — 粘贴一个 key,或引用一个环境变量,例如 `${ANTHROPIC_API_KEY}`。
3. **默认模型** — 对于 key、本地和 custom provider,接受预设值或输入模型 id。
4. **代理端口** — 默认为 `10100`。
Expand Down
15 changes: 14 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 @@ -111,7 +111,7 @@ Kiro 登录需要 Kiro CLI:Unix 使用 `curl -fsSL https://cli.kiro.dev/instal

## 3. API 密钥目录

opencodex 内置 66 个预设:55 个密钥预设、7 个 OAuth 预设、3 个本地预设,以及默认的
opencodex 内置 68 个预设:57 个密钥预设、7 个 OAuth 预设、3 个本地预设,以及默认的
ChatGPT 转发预设。仪表盘的 **Add provider** 选择器会打开密钥提供商的控制台,验证并保存密钥。
主要条目包括:

Expand All @@ -131,6 +131,8 @@ ChatGPT 转发预设。仪表盘的 **Add provider** 选择器会打开密钥提
| DeepInfra | `https://api.deepinfra.com/v1/openai` |
| Hyperbolic | `https://api.hyperbolic.xyz/v1` |
| Baseten Model APIs | `https://inference.baseten.co/v1` |
| DigitalOcean Serverless Inference | `https://inference.do-ai.run/v1` |
| Scaleway Generative APIs | `https://api.scaleway.ai/v1` |
| Together | `https://api.together.xyz/v1` |
| Fireworks | `https://api.fireworks.ai/inference/v1` |
| Moonshot (Kimi API) · Kimi (coding) | `https://api.moonshot.ai/v1` · `https://api.kimi.com/coding/v1` |
Expand Down Expand Up @@ -169,6 +171,17 @@ OpenAI Chat Completions 提供商。registry 固定的 DeepInfra 模型列表 UR
并将实时发现限制为 256 KiB 和 256 条原始记录。它仅覆盖 serverless text 与 vision-language chat;独立的
image、audio 和 GPU 端点不在范围内。密钥可在 [Hyperbolic](https://app.hyperbolic.ai) 创建。

**DigitalOcean 发现:**该预设使用 model access key 访问固定的共享 Serverless Inference 主机,只公开
已鉴权 `/v1/models` 响应与 DigitalOcean 官方文档确认的 Chat Completions allowlist 的交集。未知、
Responses-only、embedding 和 media-generation 模型 id 会按 fail closed 原则排除。发现上限为 256 KiB
和 256 条原始记录;agent 专属及 dedicated 主机不在范围内。密钥可在
[DigitalOcean Control Panel](https://cloud.digitalocean.com/model-studio/manage-keys) 创建。

**Scaleway 发现:**该预设只公开已鉴权模型列表与当前 Serverless chat-model allowlist 的交集,排除
embedding 与 audio transcription,并将发现限制为 128 KiB 和 128 条原始记录。它使用默认 Project 的
共享 endpoint;带 Project ID 的 URL 和 dedicated deployment 需要配置为 custom provider。API 密钥可在
[Scaleway 控制台](https://console.scaleway.com/generative-api) 创建。

> **Baseten 范围:**该预设仅覆盖 Baseten 的共享 [Model APIs](https://docs.baseten.co/inference/model-apis/overview)。
> 本地使用可选择个人 [API 密钥](https://docs.baseten.co/organization/api-keys);共享或生产用途请使用具备
> **Call Model APIs** 权限的团队密钥。
Expand Down
2 changes: 1 addition & 1 deletion src/providers/free-directory.ts
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ const CONNECTABLE: Record<string, ConnectableOverride> = {
nscale: openAi("https://inference.api.nscale.com/v1", "https://console.nscale.com", { verification: "official" }),
nvidia: openAi("https://integrate.api.nvidia.com/v1", "https://build.nvidia.com", { supportLevel: "supported", verification: "official", documentationUrl: "https://docs.api.nvidia.com/nim/reference/llm-apis" }),
publicai: openAi("https://api.publicai.co/v1", "https://publicai.co"),
scaleway: openAi("https://api.scaleway.ai/v1", "https://console.scaleway.com/generative-api", { verification: "official" }),
scaleway: openAi("https://api.scaleway.ai/v1", "https://console.scaleway.com/generative-api", { supportLevel: "supported", verification: "official", documentationUrl: "https://www.scaleway.com/en/docs/generative-apis/api-cli/using-generative-apis/", modelsUrl: "https://api.scaleway.ai/v1/models", lastVerified: "2026-08-01" }),
sensenova: openAi("https://token.sensenova.cn/v1", "https://console.sensenova.cn", { verification: "official" }),
stepfun: openAi("https://api.stepfun.com/v1", "https://platform.stepfun.com", { verification: "official" }),
together: openAi("https://api.together.xyz/v1", "https://api.together.xyz/settings/api-keys", { supportLevel: "supported", verification: "official", documentationUrl: "https://docs.together.ai/reference/models-1" }),
Expand Down
Loading
Loading