对话补全

Request Signature

为了确保API请求的安全性，我们实施了一种基于HMAC的请求签名机制。每个API请求都需要包含以下几个HTTP头部字段：X-APPID，X-TIMESTAMP，X-NONCE，和X-SIGNATURE。

X-APPID：由后端颁发的应用程序标识符。

X-TIMESTAMP：请求发起的Unix时间戳。

X-NONCE：用于保证每次签名的唯一性的随机字符串。

X-SIGNATURE：基于HMAC生成的请求签名。

签名过程如下：

将请求体（如果存在）的参数按照字典序排序，并使用等号（=）进行键值对的拼接，然后用和号（&）连接所有的键值对，生成待签名字符串。

使用后端颁发的SECRET和待签名字符串，通过HMAC算法生成签名字符串。

服务器会对请求的X-TIMESTAMP进行校验，如果请求的时间戳低于服务器时间戳或者超过服务器时间戳30秒，都会导致验签失败。

Example

以下是Go语言生成签名并验证时间戳的一个示例：

在这个示例中，GenerateSignature函数生成签名，CheckTimestamp函数用来校验时间戳是否在服务器时间的正负30秒范围内。

请求参数

Header 参数

string

可选

示例值:

application/json

X-APPID

string

APPID

可选

X-TIMESTAMP

string

时间戳

可选

X-NONCE

string

随机字符串

可选

X-SIGNATURE

string

可选

签名字符串，需要Base64 Encode

Body 参数application/json

object {0}

示例

{
  "mid": "模型ID",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    },
    {
      "role": "assistant",
      "content": "....abcd"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

aid

string

必需

消息ID，通过这个ID调用消息查询接口，获取AI生成的内容

示例

{
  "code": 0,
  "message": "string",
  "data": {
    "aid": "string"
  }
}

Request Signature#

Example#

请求参数

示例代码

返回响应

Request Signature

Example