协议兼容
万川是 OpenAI 兼容网关。已有项目通常只改 Base URL 与 API Key 两处，不需要改调用代码。
「OpenAI 兼容」指调用协议兼容，不等于 OpenAI 的全部接口都存在。 账号、组织与 Assistants 等管理面接口不在兼容范围内。
迁移只需改两处
# 迁移前
client = OpenAI(api_key=OPENAI_KEY)
# 迁移后：只改这两行
client = OpenAI(
api_key=os.environ["WANCHUAN_API_KEY"],
base_url="https://chuanapi.com/v1",
)主入口：https://chuanapi.com/v1。末尾的 /v1 不能省略。
当前目录暴露的端点
端点类型由每个模型在公开目录里声明，不是全站统一开关。 下表是当前快照中实际出现过的端点类型 及声明它的模型数量：
| 端点类型 | 调用路径 | 典型客户端 | 模型数 |
|---|---|---|---|
| openai | /chat/completions | OpenAI SDK 及多数兼容客户端 | 117 |
| openai-response | /responses | Codex 等 Responses 风格工具 | 7 |
该表由构建期公开目录快照生成。目录之外的端点类型即使网关支持， 当前也没有模型暴露，请勿据此设计接入。
Chat Completions 与 Responses 的区别
两者都是 OpenAI 风格接口，但形态不同。/chat/completions 用一个 messages 数组表达完整对话，是目前最通用的选择；/responses 面向以「一次任务」为单位的工作流，被 Codex 一类工具使用。
当前目录中同时提供 Responses 端点的模型： grok-4.20-multi-agent-0309、grok-4.3、grok-4.5、grok-4.6、grok-build-0.1、grok-composer-2.5-fast、grok-imagine-image-2.0。
不确定用哪个时选 Chat Completions——它的客户端生态最广， 且当前目录中所有模型都提供该端点。
兼容边界
- 不提供 OpenAI 的组织管理、Assistants 等管理面接口。
- 模型能力（工具调用、视觉、推理）以目录中该模型的
capabilities字段为准， 不能假设所有模型都具备。 - 模型名不通用。必须使用万川目录中的 model id， 照搬其他平台的名称会返回 404。
- 优先使用标准
Authorization: Bearer认证；自定义 Header 的行为取决于网关，不保证透传。 max_tokens等参数的上限随模型而变，超出会返回 400。