快速开始

发出第一个请求通常只需调整两项：地址和密钥。

四个步骤#

1. 登录并确认费用归属到哪个账户
2. 为该账户充值
3. 创建一把 API 密钥
4. 发出第一个请求

1. 登录并确认账户#

注册后会自动创建一个个人工作区，可直接使用。团队协作场景应创建组织：余额、成员与权限均在组织层管理，与个人工作区完全隔离。

余额属于账户层，个人账户一份，每个组织账户各一份，彼此独立且不支持互相转账。充值前应先确认本次费用应归属到哪个账户。详见账户、组织与工作区。

2. 充值#

在控制台的账单页充值。当前采用预付额度 + 按实际消耗扣减的方式，推理部分按供应商价格结算，平台不额外加价。

充值不收取手续费，到账额度等于充值金额。详见充值与自动充值。

订阅制计费尚未上线。

3. 创建密钥#

在控制台的 API 密钥 页面创建密钥。密钥创建后仍可在该页面再次查看完整内容，无需重新生成。

密钥绑定在工作区上，该密钥产生的费用记入所属工作区对应的账户。建议按项目或按用途分别创建密钥：用量、费用与日志均按密钥统计，同一把密钥下的请求事后无法再拆分。

密钥还可以配置额度限制、可调用模型白名单与独立的路由策略，详见 API 密钥。

4. 发出第一个请求#

Amux 原生兼容 OpenAI 协议，官方 SDK 可直接使用：

from openai import OpenAI

client = OpenAI(
    base_url="https://gateway.amux.ai/v1",
    api_key="你的 Amux 密钥",
)

response = client.chat.completions.create(
    model="anthropic/claude-opus-5",
    messages=[{"role": "user", "content": "用一句话解释什么是 API 网关"}],
)

print(response.choices[0].message.content)

curl https://gateway.amux.ai/v1/chat/completions \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-opus-5",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

model 使用模型详情页给出的规范 ID，格式为 厂商/模型。从其他环境迁移而来的常见裸名（如 claude-haiku-4-5-20251001）通常也可直接使用，平台为常见模型维护了别名。

支持的协议#

四种文本协议均为原生实现，不是转译。应根据客户端使用的协议选择地址，而不是根据目标模型选择地址：

这张表列出的是四种文本协议的入口。图像、视频与异步任务端点见 API 参考的端点总表——那张表由代码生成，是端点地址的权威来源。

协议与模型是两个独立维度。 可以用 OpenAI SDK 调用 Claude，也可以用 Anthropic SDK 调用 Gemini；但并非每个模型都支持全部协议，模型详情页会列出该模型实际可用的协议。跨协议调用的参数差异见协议转换参数兼容性。

图像、视频与其他异步生成任务使用各自的端点，完整清单见 API 参考。

选择供应商#

同一个模型通常有多家供应商提供，价格、上下文长度与支持的协议可能不同。默认情况下平台会在可用供应商之间自动路由，并在失败时切换到下一家。

锁定某一家供应商，在模型 ID 后追加 :<供应商>：

{ "model": "anthropic/claude-opus-5:anthropic" }

锁定后该供应商不可用时请求直接失败，不会切换到其他供应商。

指定本次请求的排序策略，在模型 ID 后追加 :@<策略>：

{ "model": "anthropic/claude-opus-5:@price" }

可用策略为 @balanced（默认）、@price、@latency、@throughput、@reliability。

⚠️ 冒号是后缀语法的一部分，@ 不能单独附加在模型名之后。两种后缀不能同时使用——锁定供应商之后只剩一组候选，排序不再有意义。

⚠️ 策略后缀默认被密钥锁定。要允许调用方在请求中指定策略，需在密钥设置中开启「允许请求覆盖策略」。

排序策略、货源层级、指定供应商与三层配置的优先级关系，详见路由与故障转移。

确认账单#

调用完成后，可在控制台的用量与费用页查看花费、命中的供应商，以及各类 token 的分布；日志页可查看单次调用的完整记录与计费明细。

路由重试过程中失败的尝试不计费。客户端中途断开时，已经产生的用量仍会计费——对应内容已由上游生成。完整口径见计费概览。

接下来#

• 核心概念 —— 账户、工作区、密钥、模型与额度之间的关系
• 路由与故障转移 —— 请求最终落到哪一家供应商
• API 密钥 —— 限额、模型白名单与密钥级路由
• 账户、组织与工作区 —— 团队协作、成员与角色
• 集成 —— Claude Code、Cursor、Cherry Studio 等工具的接入方式
• API 参考 —— 完整的端点、参数与调用示例