在 ZenMux 上接入 Ling / Ring
如果你已经用 ZenMux 统一管理多家大模型(鉴权、配额、审计、灰度),可以把蚂蚁百灵作为一个上游提供方接入;应用侧仍然沿用 OpenAI SDK(或 OpenAI 兼容 HTTP)调用方式。
你需要准备什么
- ZenMux 网关的对外地址(示例:
https://zenmux.ai/api/v1) - ZenMux 上为业务方签发的 API Key(示例:
ZENMUX_API_KEY)
平台侧:在 ZenMux 配置百灵作为上游
百灵对外提供 OpenAI 兼容的接口形态:
- 上游 Base URL:
https://api.ant-ling.com/v1 - 上游鉴权:
Authorization: Bearer <ANT_LING_API_KEY>
因此在 ZenMux 的「上游提供方 / Provider / Upstream」配置里,按 OpenAI 兼容提供方添加即可(字段名以你的 ZenMux 版本 UI/配置为准):
- provider 类型:OpenAI Compatible(或 OpenAI)
- base_url:
https://api.ant-ling.com/v1 - api_key:填入你的百灵 API Key
- (可选)超时/重试/并发:按业务流量设置
- (可选)日志与审计:建议开启请求/响应元数据记录(注意脱敏)
随后在 ZenMux 上为业务创建一个「对外 key / token」,并把该 key 绑定到这个上游提供方或对应路由上。
业务侧:把 OpenAI SDK 指向 ZenMux
你的应用不再直接访问 https://api.ant-ling.com/v1,而是访问 ZenMux 的 OpenAI 兼容入口:
- base_url:
https://zenmux.ai/api/v1 - api_key:ZenMux 为业务签发的 key(不是百灵的 key)
下面示例使用 OpenAI 官方 SDK,便于与你站内其它教程保持一致。
在根据下述示例进行调用时,model字段的设置要以 ZenMux 平台展示的模型 ID 为准。
调用 Ling(通用对话)
OpenAI:Python
from openai import OpenAI
client = OpenAI(
base_url="https://zenmux.ai/api/v1",
api_key="<ZENMUX_API_KEY>",
)
# Chat Completion
completion = client.chat.completions.create(
model="inclusionai/ling-2.6-flash",
messages=[
{
"role": "user",
"content": "What is the meaning of life?"
}
]
)
print(completion.choices[0].message.content)
# Responses API
responses = client.responses.create(
model="inclusionai/ling-2.6-flash",
input="What is the meaning of life?"
)
print(responses)
调用 Ring(推理 / 数学 / 代码)
Ring 更适合复杂推理、数学与代码任务。对业务侧来说,调用方式与 Ling 一致,关键是 选择合适的模型名:
OpenAI:Python
from openai import OpenAI
client = OpenAI(
base_url="https://zenmux.ai/api/v1",
api_key="<ZENMUX_API_KEY>",
)
# Chat Completion
completion = client.chat.completions.create(
model="inclusionai/ring-1t",
messages=[
{
"role": "user",
"content": "What is the meaning of life?"
}
]
)
print(completion.choices[0].message.content)
常见问题
模型名应该填什么?
以 ZenMux 平台 展示的模型 ID 为准,例如:inclusionai/ling-2.6-1t、inclusionai/ling-2.6-flash、inclusionai/ling-1t、inclusionai/ring-1t等。
返回 401/403 怎么排查?
- 确认你用的是 ZenMux 的 key(不是百灵的 key)
- 确认 ZenMux 的 key 已授权访问对应路由/模型
- 平台侧确认 ZenMux 访问百灵的上游 key 仍有效、额度充足
Was this page helpful?
Last updated on