ZMoon API

高性能 AI 模型中转服务

OpenAI API 完全兼容

通过 ZMoon API，您可以轻松接入 DeepSeek、GPT、Claude 等多种主流 AI 模型。我们提供与 OpenAI API 完全兼容的接口格式，支持流式响应、智能路由、多上游切换等高级功能。

OpenAI 兼容

完全兼容 OpenAI API 格式

多模型支持

DeepSeek、GPT、Claude 等

流式响应

支持 SSE 流式输出

智能路由

自动选择最优上游

请求地址

BASE URL https://api.zmoon.xyz/v1

兼容说明：我们的 API 完全遵循 OpenAI API 规范，支持所有标准的 OpenAI 端点。您可以使用任何支持 OpenAI 格式的 SDK、库或工具，只需将 base URL 修改为 https://api.zmoon.xyz/v1 即可。

支持的端点

端点	说明
`/v1`	聊天补全（主流端点，推荐）
`/v1`	通用接口（兼容旧版调用）

快速配置示例

使用 OpenAI Python SDK：

                                from openai import OpenAI

client = OpenAI(
    base_url="https://api.zmoon.cn/v1",
    api_key="your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.2",
    messages=[{"role": "user", "content": "你好"}]
)
                            

上游平台

我们接入了多个优质上游平台，系统会自动选择默认上游，您也可以通过 upstream 参数指定特定平台。

硅基流动CN版 (SiliconFlow CN) 运行中

默认上游平台，提供稳定的 DeepSeek 模型服务

支持模型：

deepseek-ai/DeepSeek-V3.2 deepseek-ai/DeepSeek-V2.5 deepseek-ai/DeepSeek-R1-0528-Qwen3-8B deepseek-ai/DeepSeek-R1-Distill-Qwen-32B tencent/Hunyuan-MT-7B Qwen/Qwen3-8B inclusionAI/Ling-mini-2.0

阿里云百炼 (Bailian) 暂停中

阿里云大模型服务平台，支持通义系列模型

支持模型：

指定上游：在请求中添加 "upstream" 参数即可指定使用特定上游平台。

认证方式

必填参数：所有 API 请求都必须包含有效的 API Key，否则将返回 401 错误。

方式一：Authorization Header（推荐）

使用标准的 Bearer Token 格式，这是 OpenAI 官方推荐的方式：

Authorization: Bearer your-api-key

方式二：请求体参数（兼容旧版）

也可以在请求体中传递 apikey 字段：

                                {
  "apikey": "your-api-key",
  "model": "deepseek-ai/DeepSeek-V3.2",
  "messages": [...]
}
                            

获取 API Key

请加入我们的Q群获取 API Key：

Q群 859278686

API 端点

POST https://api.zmoon.xyz/v1

提示：目前仅支持文本对话。

请求头

Header	必填	说明
Content-Type	是	固定值：application/json
Authorization	是	Bearer your-api-key

请求参数

参数	类型	必填	说明
model	string	是	模型名称
messages	array	是	消息数组
stream	boolean	否	是否流式输出，默认 true
temperature	float	否	采样温度，0-2之间
max_tokens	integer	否	最大生成 token 数
upstream	string	否	指定上游平台

messages 格式

                                [
  {"role": "system", "content": "你是一个有用的助手"},
  {"role": "user", "content": "你好"},
  {"role": "assistant", "content": "你好！有什么可以帮助你的吗？"},
  {"role": "user", "content": "介绍一下自己"}
]
                            

注意：system 角色会被自动转换为 user 角色，以兼容所有模型。

代码示例

cURL

                                curl -X POST "https://api.zmoon.cn/v1" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V3.2",
    "messages": [{"role": "user", "content": "你好"}]
  }'
                            

Python (OpenAI SDK)

                                from openai import OpenAI

client = OpenAI(
    base_url="https://api.zmoon.cn/v1",
    api_key="your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.2",
    messages=[{"role": "user", "content": "你好"}]
)

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

JavaScript

                                const response = await fetch('https://api.zmoon.cn/v1', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-api-key'
  },
  body: JSON.stringify({
    model: 'deepseek-ai/DeepSeek-V3.2',
    messages: [{role: 'user', content: '你好'}]
  })
});

const data = await response.json();
console.log(data.choices[0].message.content);
                            

流式响应 (Python)

                                from openai import OpenAI

client = OpenAI(
    base_url="https://api.zmoon.cn/v1",
    api_key="your-api-key"
)

stream = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3.2",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
                            

响应格式

成功响应 (200 OK)

                                {
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "deepseek-ai/DeepSeek-V3.2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！很高兴为你服务。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}
                            

流式响应 (SSE)

                                data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"你好"}}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"！"}}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{},"finish_reason":"stop"}]}

data: [DONE]

字段说明

字段	说明
id	请求唯一标识
choices	生成结果数组
choices[].message.content	生成的文本内容
usage	Token 使用情况

错误码

状态码	说明	解决方案
400	请求参数错误	检查请求体格式和参数
401	API Key 无效或缺失	检查 Authorization Header
403	IP 被限制	联系管理员解除限制
429	请求过于频繁	降低请求频率
500	服务器内部错误	稍后重试或联系支持
502	上游服务异常	切换上游平台或稍后重试

错误响应格式

                                {
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": 401
  }
}
                            

安全机制

IP 限制

支持 IP 白名单和黑名单功能，后台配置允许或禁止访问的 IP 地址。

请求限流

每个 API Key 有请求频率限制，防止滥用。超过限制将返回 429 错误。

内容安全

系统会对请求内容进行敏感词过滤，违规内容将被拦截。

数据加密

所有数据传输使用 HTTPS 加密，确保通信安全。

安全提示：请勿在客户端代码中暴露 API Key，建议通过后端服务调用 API。

联系我们

官网

https://www.zmoon.xyz

邮箱

3635716439@qq.com

点击按钮加入官方 QQ 群，获取技术支持和最新资讯