GLM-4.7-Flash

接口说明

GLM-4.7-Flash 是一个免费开放的 AI 聊天接口，用于向模型发送文本内容并获取对话回复。适合需要在应用、脚本或机器人中快速接入智能问答能力的开发者使用。

调用地址

https://api.styyds.qzz.io/api/ai/GLM-4.7-Flash.php

请求方式

GET

鉴权说明

调用本接口必须携带密钥，密钥通过 Query 参数 key 传递，即在请求地址后追加 key=你的密钥。未携带或密钥无效时无法正常调用。

请求参数

调用地址：https://api.styyds.qzz.io/api/ai/GLM-4.7-Flash.php

请求方式：GET

鉴权方式：密钥通过 Query 参数 key 传递。

参数取值说明：

• think：布尔型开关，传入即启用思考模式，不传则按默认行为返回。
• qq：作为会话标识使用，传入相同值可延续同一段记忆；不传则不保存记忆。
• del：仅用于删除记忆，传入目标会话 ID 后该会话的历史记忆被清除，与 qq 传入相同值时以删除操作为准。

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "text": "你好！很高兴见到你，有什么我可以帮你的吗？",
    "qq": "3199404422"
  }
}

响应字段说明

说明：

• 传入 del 参数删除指定会话记忆时，data.text 返回删除结果提示，data.qq 为被删除的会话 ID。
• 未传入 qq 参数时，接口不保存本次对话记忆，data.qq 为空字符串。

错误响应示例

当请求未通过校验或服务端无法完成处理时，接口返回统一的 JSON 结构，HTTP 状态码可能为 200，具体结果以响应体中的 code 与 errcode 为准。

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

{
  "code": 0,
  "msg": "密钥错误",
  "errcode": 11002
}

{
  "code": 0,
  "msg": "请求过于频繁（QPM 限制）",
  "errcode": 11005
}

{
  "code": 0,
  "msg": "接口维护中",
  "errcode": 11006
}

字段说明：

业务错误码说明

补充说明：

• 11001～11003、11023 属于密钥校验类错误，请确认调用地址中已通过 Query 方式携带正确的 key。
• 11004、11024 属于积分相关错误，免费接口通常不会触发，若出现请核对账户积分状态。
• 11005 为频率限制，降低单位时间内的请求次数后可恢复。
• 11006～11008 表示当前接口的可用状态异常，请稍后重试。
• 11009、11010 为校验或积分系统临时不可用，稍后重试即可。
• 11011、11012 表示密钥与鉴权方式不匹配，请按首选鉴权方式传参。
• 11013～11016 在代理类接口中同样可能出现，表示目标地址或转发过程异常。
• 11017～11022 涉及服务可用性与出口代理配置，属于服务端状态类错误。
• 11018 表示请求方式与接口定义不符，本接口应使用 GET。

调用示例

终端 curl（bash）

curl -G "https://api.styyds.qzz.io/api/ai/GLM-4.7-Flash.php" \
  --data-urlencode "key=你的密钥" \
  --data-urlencode "text=你好" \
  --data-urlencode "think=flash" \
  --data-urlencode "system=你是一个助手" \
  --data-urlencode "qq=3199404422"

删除指定会话记忆：

curl -G "https://api.styyds.qzz.io/api/ai/GLM-4.7-Flash.php" \
  --data-urlencode "key=你的密钥" \
  --data-urlencode "text=你好" \
  --data-urlencode "del=3199404422"

PHP

// PHP 示例
$params = [
    'key'    => '你的密钥',
    'text'   => '你好',
    'think'  => 'flash',
    'system' => '你是一个助手',
    'qq'     => '3199404422',
];

$url = 'https://api.styyds.qzz.io/api/ai/GLM-4.7-Flash.php?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

注意事项

• 密钥传递：调用密钥通过 Query 参数 key 传递，请将其视为私密凭据妥善保管，不要写入前端页面、公开仓库或可被他人查看的日志中；一旦泄露建议立即更换。
• 传输安全：请始终使用 https:// 访问调用地址，避免在明文 HTTP 下携带 key，防止密钥在链路中被截获。
• 参数必填：key 与 text 为必填项，缺少任一参数将无法正常返回结果；text 建议传入明确的自然语言内容，空字符串或纯空白可能得不到有效回复。
• think 取值：该参数为布尔开关，示例值 flash 表示开启快速思考模式；请按布尔语义传值，不要传入其它无意义字符串，以免行为与预期不符。
• system 使用：提示词用于设定 AI 的角色与回答风格，仅在需要固定人设或约束输出时传入，过长内容可能影响响应速度。
• 会话记忆：qq 作为会话 ID 用于保存上下文记忆，同一 ID 的多次请求会共享历史；若希望每次对话相互独立，请勿复用同一 ID。
• 记忆删除：del 填入会话 ID 即可清除该 ID 已保存的记忆，删除后不可恢复，请确认 ID 无误后再调用，避免误删其它会话数据。
• 频率控制：本接口免费提供，请勿高频轮询或批量并发调用；持续超量请求可能被限流，建议在业务侧加入适当的调用间隔与重试退避。
• 返回处理：接口未提供固定返回示例，实际响应结构可能随模型输出变化，请在代码中做好异常与空结果的兼容处理，不要依赖固定字段顺序。