概览
最近更新：2026年9月1日
Amux API 的端点、鉴权、模型 ID 与路由语法。
Amux 提供 OpenAI、Anthropic、Google Gemini 兼容端点，以及统一的异步生成端点。你可以继续使用现有 SDK，只需替换 API 地址和密钥。
地址与端点
- API 主机：
https://gateway.amux.ai - OpenAI SDK
base_url：https://gateway.amux.ai/v1
端点按调用方式分为三类：
文本生成（协议可转换）
| 协议 | 方法 | 路径 |
|---|---|---|
| OpenAI Chat Completions | POST | /v1/chat/completions |
| OpenAI Responses | POST | /v1/responses |
| Anthropic Messages | POST | /v1/messages |
| Google Gemini | POST | /v1beta/models/{model}:generateContent /v1/models/{model}:generateContent |
图像生成与编辑
| 协议 | 方法 | 路径 |
|---|---|---|
| Google Gemini | POST | /v1beta/models/{model}:generateContent /v1/models/{model}:generateContent |
| OpenAI Images | POST | /v1/images/generations |
| OpenAI Images (edit) | POST | /v1/images/edits |
通用异步生成
| 协议 | 方法 | 路径 |
|---|---|---|
| Amux Tasks | POST | /v1/tasks |
| Amux Tasks (get) | GET | /v1/tasks/{id} |
| Amux Tasks (cancel) | POST | /v1/tasks/{id}/cancel |
四种文本协议可以相互转换，但具体模型支持哪些入口仍以模型详情页为准。OpenAI Images 端点仅用于图像生成与编辑，不参与文本协议转换。
Gemini 的 generateContent 在文本与图像两组里都出现——那是同一条地址，由请求体里的 generationConfig.responseModalities 决定这次出文本还是出图。
Amux Tasks 是通用的异步媒体接口。模态由 model 决定，图片、视频、音频等任务共用同一组提交与查询路径；当前可用模型以模型目录为准。
鉴权
使用 Amux API 密钥，并按客户端所用协议传入：
| 协议 | 鉴权方式 |
|---|---|
| OpenAI 兼容端点、Amux Tasks | Authorization: Bearer <key> |
| Anthropic Messages | x-api-key: <key> |
| Google Gemini | x-goog-api-key: <key> 或 URL 参数 ?key=<key> |
API 密钥可在控制台的密钥页面创建和查看。
模型名
推荐使用模型详情页提供的规范 ID，格式为 厂商/模型：
anthropic/claude-opus-5
openai/gpt-5.6
deepseek/deepseek-v3.2
部分常见模型名也支持别名。新接入建议始终使用规范 ID，避免歧义。
指定供应商
默认情况下，Amux 会在可用供应商中路由请求。如需固定供应商，在模型 ID 后追加 :<供应商>：
anthropic/claude-opus-5:anthropic
固定后不会自动切换到其他供应商。需要故障切换时，请不要添加供应商后缀。
指定路由策略
在模型 ID 后追加 :@<策略>，可以为单次请求指定供应商排序方式：
anthropic/claude-opus-5:@price
| 后缀 | 说明 |
|---|---|
@balanced | 综合可用性与渠道权重，默认策略 |
@price | 价格较低的优先 |
@latency | 首字延迟较低的优先 |
@throughput | 输出速度较快的优先 |
@reliability | 成功率较高的优先 |
路由策略只调整当前密钥可用供应商的顺序，不会扩大供应商范围。供应商后缀与策略后缀不能同时使用；如果 API 密钥已固定路由策略，请求中不能再指定策略。
协议与模型是两件事
协议和模型是两个独立维度。模型详情页会列出该模型支持的协议；不支持的组合会返回错误，不会自动降级。
跨协议调用时，部分参数可能被转换或忽略。具体规则见协议转换参数兼容性。