API 文档

ZSaosu API 兼容 OpenAI API 格式，任何支持 OpenAI 的 SDK / 工具 / 框架均可无缝接入。

🔐 认证方式

所有 API 请求通过 HTTP Header 中的 Authorization 字段携带 API Key 进行认证：

Authorization: Bearer sk-你的API密钥

• 在 API 平台 登录后，在「令牌管理」页面创建和管理 API Key
• API Key 开头为 sk-，是标准 OpenAI 兼容格式
• 请妥善保管 API Key，不要泄露给他人

📍 Base URL

🚀 快速接入

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    base_url="https://api.zsaosu.com/v1",
    api_key="sk-你的API密钥"
)

response = client.chat.completions.create(
    model="glm-5.2",
    messages=[
        {"role": "user", "content": "你好"}
    ]
)

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

cURL

curl https://api.zsaosu.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的API密钥" \
  -d '{
    "model": "glm-5.2",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Node.js

import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://api.zsaosu.com/v1",
    apiKey: "sk-你的API密钥",
});

const response = await client.chat.completions.create({
    model: "glm-5.2",
    messages: [{ role: "user", content: "你好" }],
});

console.log(response.choices[0].message.content);

💬 Chat 对话

POST /v1/chat/completions

发起一次对话请求，返回模型生成的回复。兼容 OpenAI Chat Completions API。

请求参数

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1720000000,
  "model": "glm-5.2",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "你好！我是 GLM..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 8,
    "total_tokens": 18
  }
}

⚡ 流式输出（Stream）

在请求体中加入 "stream": true，即可开启 SSE（Server-Sent Events）流式输出：

# cURL 流式调用
curl https://api.zsaosu.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.2","messages":[{"role":"user","content":"你好"}],"stream":true}'

# Python 流式调用
from openai import OpenAI

client = OpenAI(base_url="https://api.zsaosu.com/v1", api_key="sk-xxx")

stream = client.chat.completions.create(
    model="glm-5.2",
    messages=[{"role": "user", "content": "你好"}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

📋 模型列表

GET /v1/models

获取当前可用的所有模型。

更多模型持续接入中，敬请期待。

💰 模型定价

GLM-5.2

计费方式：按量计费，用多少扣多少，无最低消费要求。

🏷️ 分组折扣

根据用户分组享受不同的价格折扣：

❌ 错误码

# 错误响应格式
{
  "error": {
    "message": "Invalid token (request id: ...)",
    "type": "new_api_error"
  }
}

🚦 速率限制

• 默认单 Key 每分钟 60 次请求
• 流式请求同样计入限制
• 触发限制后返回 HTTP 429，请等待后重试
• 如需提高限制，请联系管理员

🙋 常见问题