MuxLLM 使用文档

Quick Start

五步完成首次接入

1. 注册账号 进入 MuxLLM 控制台创建账号并登录。
2. 充值余额 按实际使用量充值，余额和消费记录可在控制台查看。
3. 创建 API Key 为不同客户端、项目或团队场景创建独立令牌。
4. 选择模型与端点 在模型广场确认模型名称、分组、价格和支持的端点标签。
5. 测试后接入 先用最小请求验证连接，再把配置用于正式客户端或项目。

Endpoint

接口地址

Base URL 取决于客户端使用的协议。不要同时在客户端和地址中重复填写路径版本。

Protocols

如何选择调用端点

模型广场会为每个模型显示一个或多个端点标签。请求路径、认证头和客户端类型都应与标签匹配。

路由存在只表示平台能够接收该类请求，不代表每个模型或分组都支持该端点。最终以目标模型的实时端点标签为准。

OpenAI

OpenAI 兼容与 Responses API

OpenAI 兼容客户端通常使用带 /v1 的 Base URL。示例中的 MODEL_NAME 需要替换为模型广场中的精确模型名。

curl https://api.muxllm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用三句话介绍 MuxLLM。"
      }
    ]
  }'

curl https://api.muxllm.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "input": "概括一下统一模型 API 接入的价值。"
  }'

Anthropic

Claude 原生调用

Claude 原生接口使用站点主机地址，不在 Base URL 后额外添加 /v1。目标模型必须显示 anthropic 标签。

curl https://api.muxllm.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，请说明这个接口使用的协议。"
      }
    ]
  }'

Gemini

Gemini 原生调用

Gemini 原生请求把模型名放在 URL 路径中。目标模型必须显示 gemini 标签。

curl https://api.muxllm.com/v1beta/models/MODEL_NAME:generateContent \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "你好，请概括这次请求的内容。" }
        ]
      }
    ]
  }'

Media

图片与视频模型

图片和视频模型并不共用一种固定协议。先查看模型的端点标签，再选择对应请求结构。

curl https://api.muxllm.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "prompt": "一张干净、现代的人工智能工作台产品图"
  }'

curl https://api.muxllm.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=MODEL_NAME" \
  -F "prompt=雨后的城市街道，镜头缓慢向前移动"

curl https://api.muxllm.com/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Clients

常用客户端配置

客户端界面可能随版本变化，但核心字段始终是协议类型、Base URL、API Key 和精确模型名。

Troubleshooting

常见错误与排查顺序

同一个状态码可能有多种原因。先查看控制台用量日志和响应错误信息，再按下面的顺序检查。

1. 1
   确认账户

   检查余额、账号状态和 API Key 是否仍然有效。

2. 2
   确认模型

   模型名必须与模型广场完全一致，包括大小写、连字符和版本号。

3. 3
   确认协议

   路径、认证头和请求体必须与模型显示的端点标签一致。

4. 4
   查看日志

   记录请求时间、模型名和错误信息；排查时不要提供完整 API Key。

Billing

账户、余额与 API Key

余额、充值记录和调用消耗在 MuxLLM 控制台中管理。不同模型、分组和媒体规格的价格可能不同，调用前请查看实时模型广场。

FAQ

常见问题