简体中文

English

简体中文

English

Appearance

快速开始 ​

欢迎使用 ZenMux！本指南将帮助你快速上手，展示如何通过三种不同的方法调用 ZenMux API。

💡 四步即可开始

只需要四个简单步骤，即可开始使用 ZenMux：

  1. 登录 ZenMux：访问 ZenMux 登录页面，选择以下任一方式登录：

    • 邮箱登录
    • GitHub 账号登录
    • Google 账号登录

  2. 获取 API 密钥：登录后，前往你的 用户控制台 > API Keys 页面，创建一个新的 API Key。

  3. 选择调用方式：我们推荐使用 OpenAI SDK 或 Anthropic SDK 的兼容模式，也可以直接调用 ZenMux API。

  4. 发起你的第一个请求：复制下面的代码示例，替换你的 API Key，即可运行。

模型Slug获取说明

ZenMux平台的模型具备唯一Slug，您可以通过模型列表页获取对应模型的Slug: model-slug 或者某个模型的模型详情页获取对应模型的Slug: model-slug

方法一：使用 OpenAI SDK ​

兼容性说明

ZenMux 的 API 端点与 OpenAI API 完全兼容，只需修改两个参数即可无缝切换。

代码示例 ​

python
from openai import OpenAI

# 1. 初始化 OpenAI 客户端
client = OpenAI(
    # 2. 将基础 URL 指向 ZenMux 端点
    base_url="https://zenmux.ai/api/v1", 
    # 3. 替换为你从 ZenMux 用户控制台获取的 API Key
    api_key="<你的 ZENMUX_API_KEY>", 
)

# 4. 发起请求
completion = client.chat.completions.create(
    # 5. 指定你想使用的模型，格式为 "供应商/模型名称"
    model="openai/gpt-5", 
    messages=[
        {
            "role": "user",
            "content": "生命的意义是什么？"
        }
    ]
)

print(completion.choices[0].message.content)
ts
import OpenAI from "openai";

// 1. 初始化 OpenAI 客户端
const openai = new OpenAI({
  // 2. 将基础 URL 指向 ZenMux 端点
  baseURL: "https://zenmux.ai/api/v1", 
  // 3. 替换为你从 ZenMux 用户控制台获取的 API Key
  apiKey: "<你的 ZENMUX_API_KEY>", 
});

async function main() {
  // 4. 发起请求
  const completion = await openai.chat.completions.create({
    // 5. 指定你想使用的模型，格式为 "供应商/模型名称"
    model: "openai/gpt-5", 
    messages: [
      {
        role: "user",
        content: "生命的意义是什么？", 
      },
    ],
  });

  console.log(completion.choices[0].message);
}

main();

方法二：使用 Anthropic SDK ​

兼容性说明

ZenMux 完全支持 Anthropic API 协议，可以无缝集成到 Claude Code、Cursor 等工具中。只需修改两个参数即可使用。

注意 Anthropic 协议的 base_url="https://zenmux.ai/api/anthropic"。

Anthropic协议支持模型说明

支持Anthropic协议的模型正在分批适配中，当前已支持的模型可以通过官方模型列表筛选Anthropic API Compatible查看: anthropic-support 或者也可以通过模型详情页查看: anthropic-support

代码示例 ​

python
from anthropic import Anthropic

# 1. 初始化 Anthropic 客户端
client = Anthropic(
    # 2. 将基础 URL 指向 ZenMux 端点
    base_url="https://zenmux.ai/api/anthropic", 
    # 3. 替换为你从 ZenMux 用户控制台获取的 API Key
    api_key="<你的 ZENMUX_API_KEY>", 
)

# 4. 发起请求
message = client.messages.create(
    # 5. 指定你想使用的模型，格式为 "供应商/模型名称"
    model="anthropic/claude-sonnet-4.5", 
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "生命的意义是什么？"
        }
    ]
)

print(message.content[0].text)
ts
import Anthropic from "@anthropic-ai/sdk";

// 1. 初始化 Anthropic 客户端
const client = new Anthropic({
  // 2. 将基础 URL 指向 ZenMux 端点
  baseURL: "https://zenmux.ai/api/anthropic", 
  // 3. 替换为你从 ZenMux 用户控制台获取的 API Key
  apiKey: "<你的 ZENMUX_API_KEY>", 
});

async function main() {
  // 4. 发起请求
  const message = await client.messages.create({
    // 5. 指定你想使用的模型，格式为 "供应商/模型名称"
    model: "anthropic/claude-sonnet-4.5", 
    max_tokens: 1024,
    messages: [
      {
        role: "user",
        content: "生命的意义是什么？", 
      },
    ],
  });

  console.log(message.content[0].text);
}

main();

方法三：直接调用 ZenMux API ​

python
import httpx

# 准备请求数据
api_key = "<你的 ZENMUX_API_KEY>"
headers = {
    "Authorization": f"Bearer {api_key}", 
}
payload = {
    "model": "openai/gpt-5", 
    "messages": [
        {
            "role": "user",
            "content": "生命的意义是什么？"
        }
    ]
}

# 发送 POST 请求
response = httpx.post(
    "https://zenmux.ai/api/v1/chat/completions", 
    headers=headers,
    json=payload,
    timeout=httpx.Timeout(60.0)
)

# 检查请求是否成功（可选）
response.raise_for_status()

# 打印服务器返回的 JSON 响应
print(response.json())
typescript
fetch("https://zenmux.ai/api/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer <你的 ZENMUX_API_KEY>", 
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "openai/gpt-5", 
    messages: [
      {
        role: "user",
        content: "生命的意义是什么？", 
      },
    ],
  }),
})
  .then((response) => response.json())
  .then((data) => console.log(data))
  .catch((error) => console.error("Error:", error));
bash

curl https://zenmux.ai/api/v1/chat/completions
  -H "Content-Type: application/json"
  -H "Authorization: Bearer $ZENMUX_API_KEY"
  -d '{
    "model": "openai/gpt-5",
    "messages": [
      {
        "role": "user",
        "content": "生命的意义是什么？"
      }
    ]
  }'

高级用法 ​

关于高级用法的详细信息，请参阅高级调用章节的内容。

联系我们

如果您在使用过程中遇到任何问题，或有任何建议和反馈，欢迎通过以下方式联系我们：

更多联系方式和详细信息，请访问我们的联系我们页面。