智谱对话（OpenAI 兼容） - 数字先锋API文档

# 智谱 GLM（OpenAI 兼容）API 文档
‌GLM-5-Turbo‌ 是智谱（Zhipu AI）于 ‌2026年3月16日‌ 正式发布的面向 ‌OpenClaw“龙虾”场景深度优化的基座模型‌，被业界称为全球首个专为AI智能体（Agent）长链路任务执行设计的“原生龙虾模型”。
🔧 普通AI：只给建议、给模板
🚀 龙虾AI（GLM-5-Turbo）：直接执行、自动完成、全程无需盯
## 1. 概述

本平台提供智谱 GLM 模型的 OpenAI 兼容调用方式，开发者可使用 OpenAI 协议快速接入。

- **Base URL**: `https://api.cxsee.com/v1`
- **Endpoint**: `POST /chat/completions`
- **协议兼容**: OpenAI Chat Completions

---

## 2. 认证

请求头需携带 API Key：

```http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

---

## 3. 支持模型

- `glm-5-turbo`

---

## 4. 请求参数

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型名称，如 `glm-5-turbo` |
| messages | array | 是 | 对话消息（OpenAI 标准格式） |
| stream | boolean | 否 | 是否流式返回，默认 `false` |
| temperature | number | 否 | 采样温度（可选） |
| max_tokens | number | 否 | 最大输出长度（可选） |

`messages` 示例：
```json
[
  {"role": "user", "content": "你好，介绍下自己"}
]
```

---

## 5. 请求示例（cURL）

```bash
curl -X POST "https://api.cxsee.com/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5-turbo",
    "messages": [
      {"role": "user", "content": "你好，介绍下自己"}
    ]
  }'
```

---

## 6. 成功响应示例

```json
{
  "id": "202603211238533b5b595e2e424f29",
  "object": "chat.completion",
  "created": 1774067937,
  "model": "glm-5-turbo",
  "request_id": "202603211238533b5b595e2e424f29",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "你好！我是Z.ai训练的GLM大语言模型...",
        "reasoning_content": "让我思考一下如何介绍自己..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 256,
    "total_tokens": 266,
    "prompt_tokens_details": {
      "cached_tokens": 2
    },
    "completion_tokens_details": {
      "reasoning_tokens": 182
    }
  }
}
```

---

## 7. 响应字段说明

### 顶层字段
- `id`：请求唯一标识
- `object`：对象类型，固定为 `chat.completion`
- `created`：时间戳
- `model`：实际使用模型
- `request_id`：请求追踪 ID（用于排障）

### choices
- `choices[0].message.content`：模型最终回复内容
- `choices[0].message.reasoning_content`：模型思考过程（如通道开启/支持）
- `choices[0].finish_reason`：结束原因（如 `stop`）

### usage
- `prompt_tokens`：输入 token 数
- `completion_tokens`：输出 token 数
- `total_tokens`：总 token
- `prompt_tokens_details.cached_tokens`：缓存命中 token
- `completion_tokens_details.reasoning_tokens`：思考 token（若返回）

---

## 8. 错误响应格式

```json
{
  "error": {
    "message": "错误信息",
    "type": "error_type",
    "code": "error_code"
  }
}
```

常见错误：
- `401`：API Key 无效
- `429`：请求过于频繁
- `400/403`：模型无权限或参数错误
- `402/余额类错误`：账户额度不足

---

## 9. Python（OpenAI SDK）示例

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.cxsee.com/v1"
)

resp = client.chat.completions.create(
    model="glm-5-turbo",
    messages=[
        {"role": "user", "content": "你好，介绍下自己"}
    ],
    stream=False
)

print(resp.choices[0].message.content)
```

---

## 10. 接入建议（生产环境）

- 记录 `request_id`、`id` 用于故障排查
- 对 `429/5xx` 做指数退避重试
- 对 `usage.total_tokens` 做计费统计
- 若返回 `reasoning_content`，可按业务需求选择展示或过滤

---

上一篇：X.AI 对话（OpenAI 兼容）下一篇：千问Qwen 对话（OpenAI 兼容）