Skip to Content

在 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_urlhttps://zenmux.ai/api/v1
  • api_key:ZenMux 为业务签发的 key(不是百灵的 key)

下面示例使用 OpenAI 官方 SDK,便于与你站内其它教程保持一致。

在根据下述示例进行调用时,model字段的设置要以 ZenMux 平台展示的模型 ID 为准。


调用 Ling(通用对话)

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 一致,关键是 选择合适的模型名

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-1tinclusionai/ling-2.6-flashinclusionai/ling-1tinclusionai/ring-1t等。

返回 401/403 怎么排查?

  • 确认你用的是 ZenMux 的 key(不是百灵的 key)
  • 确认 ZenMux 的 key 已授权访问对应路由/模型
  • 平台侧确认 ZenMux 访问百灵的上游 key 仍有效、额度充足
Was this page helpful?
Last updated on