from openai import OpenAI

client = OpenAI(
    base_url="https://openmux.ai/v1",
    api_key="om-sk-your-key",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

base URL 与模型无关：用 OpenAI SDK 时，无论选 Claude、GPT、DeepSeek 还是 GLM，base URL 都是 /v1，只有 model 参数变。只有改用 Anthropic 原生 SDK 才用不带 /v1 的根域名。

在体验页试用 →

图片生成

使用 gpt-image-2 模型生成图片。图片生成走独立端点 —— POST /v1/images/generations，不在对话(chat)端点里完成。直接用你现有的 om-sk- Key，无需任何额外配置。

API Key 完全不用改，只是换一个端点、把 model 设为 gpt-image-2 即可。

curl https://openmux.ai/v1/images/generations \
  -H "Authorization: Bearer om-sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a cute orange cat wizard casting a glowing blue spell",
    "size": "1024x1024",
    "quality": "low",
    "n": 1
  }'

请求参数

model必填必填，固定为 gpt-image-2。

prompt必填必填，对想要图片的文字描述。

size1024x1024（默认）、1536x1024、1024x1536 或 auto。

qualitylow / medium / high / auto。质量越高效果越好但更慢。

n生成图片数量（默认 1）。

返回内容

响应在 data[0].b64_json 里返回 base64 编码的 PNG（不是 URL）。需要自己解码并保存为 .png 文件（见下方示例）。响应里也附带 usage 字段（token 用量）。

超时

生成耗时随尺寸和质量约 10–90 秒，客户端超时请设到至少 120 秒。

编辑已有图片

用 POST /v1/images/edits（multipart/form-data）编辑图片：上传一张或多张原图 + 描述改动的 prompt。模型同为 gpt-image-2，返回同样的 base64 PNG。

curl

curl https://openmux.ai/v1/images/edits \
  -H "Authorization: Bearer om-sk-your-key" \
  -F "model=gpt-image-2" \
  -F "prompt=add a small wizard hat on the cat" \
  -F "size=1024x1024" \
  -F "image=@input.png;type=image/png"

python

from openai import OpenAI
import base64

client = OpenAI(base_url="https://openmux.ai/v1", api_key="om-sk-your-key")

result = client.images.edit(
    model="gpt-image-2",
    image=open("input.png", "rb"),   # one or more source images
    prompt="add a small wizard hat on the cat",
    size="1024x1024",
)

img = base64.b64decode(result.data[0].b64_json)
with open("edited.png", "wb") as f:
    f.write(img)

Claude Code

bash

export ANTHROPIC_BASE_URL="https://openmux.ai"
export ANTHROPIC_AUTH_TOKEN="om-sk-your-key"
claude -p "hi"

Base URL 为 https://openmux.ai，不带 /v1 —— 与上面 OpenAI 格式的 base URL 不同。

要用 ANTHROPIC_AUTH_TOKEN，不要用 ANTHROPIC_API_KEY —— 第三方网关只有走 auth-token 才能稳定生效，用 API_KEY 可能会卡在"Not logged in"。

让 AI agent 帮你自动配置 →

Cursor

打开 Cursor 设置，选择兼容 OpenAI 的模型设置，将 Base URL 设为 https://openmux.ai/v1，然后粘贴 OpenMux API Key。

让 AI agent 帮你自动配置 →

Codex

Codex CLI 会无视单独设置的 OPENAI_BASE_URL —— 只认下面这种通过 -c 覆盖或写进 config.toml 定义的自定义 provider。

bash

export OPENMUX_KEY="om-sk-your-key"
codex exec -c model_providers.openmux.base_url="https://openmux.ai/v1" -c model_providers.openmux.wire_api="responses" -c model_providers.openmux.env_key="OPENMUX_KEY" -c model_provider="openmux" "hi"

Codex 完整接入指南（config.toml、桌面版、故障排查）

Anthropic Native

使用 Anthropic 原生 /v1/messages 端点，同样使用 OpenMux Key：

bash

curl https://openmux.ai/v1/messages \
  -H "x-api-key: om-sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

错误码

401API Key 无效或缺失

402余额不足 — 请充值

404模型未找到或未激活

429请求频率超限 — 每个 Key 每分钟 60 次

500上游错误 — 我们会转发服务商的错误信息

常见问题 (FAQ)

omcodex/omclaude token 消耗、接入排查、配置优化