Use Volcengine Ark in Codex

Prices and modelsEndpoint verified 2026-11-09

Generate a Codex config from the Responses-compatible endpoint in Volcengine Ark's docs. The API key in the config is a placeholder; replace it with a key you create at Volcengine Ark.

Endpoints

Pay as you gohttps://ark.cn-beijing.volces.com/api/v3Use the model ID from the Ark console.Docs · verified 2026-11-09
Plan only: Ark Coding Plan Lite, Prohttps://ark.cn-beijing.volces.com/api/coding/v3Docs · verified 2026-11-09
Plan only: Ark Agent Plan Small, Medium, Large, Maxhttps://ark.cn-beijing.volces.com/api/plan/v3Docs · verified 2026-11-09

Generate the config

Save to ~/.codex/config.toml; merge it in if the file already exists

model = "kimi-k3-1-pro-261024"
model_provider = "volcengine-ark"

[model_providers.volcengine-ark]
name = "Volcengine Ark"
base_url = "https://ark.cn-beijing.volces.com/api/v3"
env_key = "VOLCENGINE_ARK_API_KEY"
wire_api = "responses"

Applies to the current terminal only, for a quick try

export VOLCENGINE_ARK_API_KEY='YOUR_API_KEY'
codex

Applies to the current PowerShell window only, for a quick try

$env:VOLCENGINE_ARK_API_KEY = 'YOUR_API_KEY'
codex

Models and prices

Model	Input	Output	Ratio
Kimi K3.1 Pro`kimi-k3-1-pro-261024`	$1.95	$10.19	1.00×
DeepSeek V4.1 Flash`deepseek-v4-1-flash`	$0.30	$1.20	2.00×
GLM-5.3-Flash`glm-5-3-flash-260828`	$0.12	$0.42	1.00×
DeepSeek V4 Pro`deepseek-v4-pro-ga-260813`	$1.35	$4.05	2.04×
DeepSeek V4 Flash`deepseek-v4-flash-ga-260731`	$0.45	$1.35	—
Doubao Seed 2.1 Turbo`doubao-seed-2-1-turbo-260628`	$0.45	$2.25	1.00×
GLM-5.2`glm-5-2-260617`	$1.20	$4.20	1.00×
Doubao Seed 2.0 Mini`doubao-seed-2-0-mini-260428`	$0.030	$0.30	1.00×
Doubao Seed 2.1 Lite`doubao-seed-2-1-lite-260915`	$0.12	$0.405	1.00×
Doubao Seed 2.1 Pro`doubao-seed-2-1-pro-260915`	$0.899	$4.50	1.00×

$ per 1M tokens. Each model uses the provider's cheapest group; the ratio uses the output price

How to check it works

Restart Codex and send a message. If it replies and the request shows up in Volcengine Ark's console, it is using this endpoint.

FAQ

Why is the key in an environment variable?

config.toml only holds the variable's name, so the key never goes into the config file and does not leak when you share or sync it. To keep it, add the export line to ~/.zshrc or ~/.bashrc.

How do I switch back to OpenAI?

Remove the model_provider line from config.toml, then restart Codex.

Does my key pass through this site?

No. The page only generates config text and never asks for your key; the key only goes into the terminal or environment variables on your own machine.

Codex configs for other providers