扣款

用途：当用户在AIDOL消费时（如聊天、生成图片等），扣除相应金币。

请求方式

bash

POST {您的域名}/api/ai-dol/v1/debit

请求头

text

Authorization: Bearer {您的apiKey}
X-Signature: {计算的签名}

请求参数

参数名	类型	是否必填	示例值	说明
account	string	是	680857435	用户 ID/账号/邮箱
type	string	是	TEXT_CHAT	类型（TEXT_CHAT、IMAGE_REQUEST、UNLOCK_ALBUM等）
amount	number	是	1	扣款金额
description	string	是	文本聊天扣款	扣款描述
requestId	string	是	req_abc123	客户端生成唯一请求标识
timestamp	number	是	1760581487000	毫秒级时间戳

响应格式（JSON）

成功响应

json

{
  "code": 10200,
  "success": true,
  "message": "OK",
  "data": {
      "transactionId": "ae4912a165eb4af895652f61023a2103",
      "balance": 1887
  },
  "timestamp": 1760582574528
}

失败响应

json

{
  "code": 10402,
  "success": false,
  "message": "余额不足",
  "data": null,
  "timestamp": 1760582574528
}

字段说明

字段名	类型	描述
transactionId	string	交易ID
balance	int	扣款后的余额

扣款 ​

扣款