接口详情

字段

传参方式

类型

必传

描述

示例值

Authorization

header

String

是

API-Key

Bearer d1**2a

字段

传参方式

类型

必传

描述

示例值

x-fag-appcode

header

String

是

应用表示，固定为 aca

x-fag-servicename

header

String

是

请求路由标识，不同接口值不一样，映射管理参考

aca-character-create

接口

路径

x-fag-appcode

对话（流式）

/v2/api/chat/send

aca-chat-send-sse

对话（非流式）

/v2/api/chat/send

aca-chat-send

字段

传参方式

类型

必传

描述

X-AcA-SSE

header

String

否

是否开启流式对话- 开启 - enable- 不开启 - disable

参数

类型

必传

说明

model

string

否

模型，默认为空，若角色有配置则按照配置路由，若无配置则按照平台默认（xingchen-plus-v2）路由

parameters

object

否

模型设置

parameters.topP

float

否

topP生成时，核采样方法的概率阈值。例如，取值为0.8时，仅保留累计概率之和大于等于0.8的概率分布中的token，作为随机采样的候选集。取值范围为(0,1.0)，取值越大，生成的随机性越高；取值越低，生成的随机性越低。默认值 0.95。注意，取值不要大于等于1

parameters.seed

long

否

seed生成时，随机数的种子，用于控制模型生成的随机性。如果使用相同的种子，每次运行生成的结果都将相同；当需要复现模型的生成结果时，可以使用相同的种子。seed参数支持无符号64位整数类型。默认值 1683806810, 范围 [0, 9223372036854775807]

parameters.temperature

float

否

较高的值将使输出更加随机，而较低的值将使输出更加集中和确定。可选，默认取值0.92

parameters.incrementalOutput

boolean

否

是否增量输出，若为true，每次流式输出不包含已输出内容，只对流式接口的输出有效

input.messages

array

是

对话历史，固定角色可通过角色配置最大对话轮数，非固定角色最大支持200条。list中的每个元素形式为{"role":角色, "content": 内容}。角色当前可选值：system、user、assistant，function，其中，仅messages[0]中支持role为system，user、assistant需要交替出现，最后一条为用户提问。

input.aca.botProfile

object

是

角色设置。name为角色名称

input.aca.botProfile.name

string

是

角色名称

input.aca.botProfile.params

Object

是

角色模板传参

input.aca.botProfile.customTemplateId

string

是

角色模板id

input.aca.botProfile.enableOpenLine

Boolean

否

角色模板场景下是否使用模板开场白

input.aca.sampleMessages

array

否

对话示例

input.aca.userProfile

object

是

用户设置userId为业务系统用户唯一标识userName对话用户名称basicInfo对话用户基本信息

input.aca.userProfile.userId

string

是

业务系统用户唯一标识，非固定角色接口支持并行对话，连续调用对话请求。

input.aca.userProfile.userName

string

否

对话用户名称

input.aca.userProfile.basicInfo

string

否

对话用户基本信息

input.aca.scenario

object

否

角色场景设置，默认为当前对话时间

input.aca.scenario.description

string

否

场景描述，可以为当前对话时间

input.aca.functionList

array

否

函数列表

function.name

string

是

函数名称，如weather

function.description

string

是

函数描述，如通过调用天气预报API获取当地天气预报信息

function.parameters

object

是

函数参数描述，如``{"type": "object", "properties": {"location": {"description": "地点", "type": "string"}, "format": {"description": "温度单位", "type": "string", "enum": ["celsius", "fahrenheit"]}}, "required": ["location", "format"]}``

参数

类型

说明

requestId

string

系统生成的标志本次调用的id。

success

boolean

是否成功返回

errorCode

int

错误码

errorName

string

错误名称

httpStatusCode

int

http错误码

errorMessage

string

错误消息

usage

object

usage.userTokens

int

用户输入的token数

usage.inputTokens

int

本次请求输入内容的 token 数目。在打开了搜索的情况下，输入的 token 数目因为还需要添加搜索相关内容支持，所以会超出客户在请求中的输入。

usage.outputTokens

int

模型生成回复转换为Token后的长度。

choices

array

消息体

choices[i].stopReason

string

完成标识符，已完成为 stop，未完成为 “null”

choices[i].messages

array

message.role

string

模型role，固定为assistant

message.content

string

模型生成消息输出

message.meta

object

消息属性

messages.meta.hasRisk

boolean

是否存在安全风险，true/false

参数

类型

说明

requestId

string

系统生成的标志本次调用的id。

success

boolean

是否成功返回

errorCode

int

错误码

errorName

string

错误名称

httpStatusCode

int

http错误码

errorMessage

string

错误消息

data

object

data.usage

object

usage.userTokens

int

用户输入的token数

usage.inputTokens

int

本次请求输入内容的 token 数目。在打开了搜索的情况下，输入的 token 数目因为还需要添加搜索相关内容支持，所以会超出客户在请求中的输入。

usage.outputTokens

int

模型生成回复转换为Token后的长度。

data.choices

array

消息体

choices[i].stopReason

string

完成标识符，已完成为 stop，未完成为 null

choices[i].messages

array

message.role

string

模型role，固定为assistant

message.content

string

模型生成消息输出

message.meta

object

消息属性

messages.meta.hasRisk

boolean

是否存在安全风险，true/false