获取高级配置
接入前提
获取调用 API 所需的 token 请参考 API 鉴权
任务创建前可以通过本接口读取页数、受众、场景、语气和语言等选项。自研表单展示用户选择后,再把结果传给 任务创建。
如果接入方不需要暴露高级配置,可以跳过本接口,按任务创建接口默认配置生成。
调用时机
| 场景 | 建议 |
|---|---|
| 自研生成表单需要页数、受众、场景、语气或语言 | 在用户提交生成前调用本接口,并把选项展示给用户 |
| 不使用高级配置 | 可以跳过本接口,直接调用 任务创建 |
| 需要保持选项更新 | 不要在前端写死选项,建议由接入方服务端缓存接口结果并定期刷新 |
表单只有在 code = 0 且配置项及其子选项都能解析时才能使用接口结果。
配置项结构
| 接口描述 | 此接口用于获取高级配置数据。 | ||
| 接口地址 | /api/ai/chat/senior/option | 请求方式 | GET |
| 权限校验 | 是 | ||
请求示例
ts
curl --location --request GET 'https://co.aippt.cn/api/ai/chat/senior/option' \
--header 'x-api-key: <apiKey>' \
--header 'x-channel: <channel>' \
--header 'x-token: <token>' \响应内容
响应示例
ts
{
"code": 0,
"data": [
{
"id": 1,
"parent_id": 0,
"name": "页数",
"key": "page",
"is_default": 0,
"is_c": 0,
"children": [
{
"id": 2,
"parent_id": 1,
"name": "15 - 20页",
"key": "",
"is_default": 0,
"is_beta": 0,
"children": null
},
...更多
]
},
{
"id": 5,
"parent_id": 0,
"name": "受众",
"key": "group",
"is_default": 0,
"is_beta": 0,
"children": [
{
"id": 6,
"parent_id": 5,
"name": "大众",
"key": "",
"is_default": 1,
"is_beta": 0,
"children": null
},
...更多
]
},
{
"id": 17,
"parent_id": 0,
"name": "场景",
"key": "scene",
"is_default": 0,
"is_beta": 0,
"children": [
{
"id": 18,
"parent_id": 17,
"name": "通用",
"key": "",
"is_default": 1,
"is_beta": 0,
"children": null
},
...更多
]
},
{
"id": 39,
"parent_id": 0,
"name": "语气",
"key": "tone",
"is_default": 0,
"is_beta": 0,
"children": [
{
"id": 40,
"parent_id": 39,
"name": "专业",
"key": "",
"is_default": 1,
"is_beta": 0,
"children": null
},
...更多
},
{
"id": 46,
"parent_id": 0,
"name": "语言",
"key": "language",
"is_default": 0,
"is_beta": 0,
"children": [
{
"id": 47,
"parent_id": 46,
"name": "简体中文",
"key": "",
"is_default": 0,
"is_beta": 0,
"children": null
},
...更多
]
}
],
"msg": "ok"
}