You need to enable JavaScript to run this app.
文档中心
Viking AI 搜索

Viking AI 搜索

复制全文
下载 pdf
对话搜索接口
QuestionSuggestions - 猜你想问
复制全文
下载 pdf
QuestionSuggestions - 猜你想问
​
注意​
受到 HTTP Body 大小限制,单次请求的包体大小最大不超过 10MB​
前置操作​
确保该应用已经开启和生效「开场推荐问题」配置,更多详情请查阅 配置对话开场。​
​
请求说明​
接口概览​
该接口独立返回用户可直接提问的问题,不生成欢迎语,也不建立或读取对话 session。​
​
参数​
说明​
请求方法​
POST​
请求路径​
{REGION_URL}/api/v1/application/{APPLICATION_ID}/question_suggestions​
Content-Type​
application/json​
鉴权​
Authorization: Bearer <API_KEY>​
返回方式​
普通 JSON,非流式​
​
服务域名​
​
服务​
区域​
URL​
火山引擎​
华北(北京)​
https://aisearch.cn-beijing.volces.com​
火山引擎​
东南亚(柔佛)​
https://aisearch.ap-southeast-1.volces.com​
BytePlus​
东南亚(柔佛)​
https://aisearch.ap-southeast-1.bytepluses.com​
​
路径参数​
​
参数​
类型​
必填​
说明​
APPLICATION_ID​
String​
是​
应用唯一标识符。​
​
请求参数​
​
参数​
类型​
必填​
说明​
user​
Object​
否​
用户信息,用于生成个性化推荐问题。​
user._user_id​
String​
否​
用户唯一标识。传入后会作为个性化推荐依据。​
user.nickname​
String​
否​
用户昵称。​
​
请求示例​
​
curl--request POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/<application_id>/question_suggestions' \​
--header 'Authorization: Bearer <API_KEY>' \​
--header 'Content-Type: application/json' \​
--data '{​
"user": {​
"_user_id": "user_123"​
}​
}'​
​
​
如果不需要个性化信息时,请求体可传空对象​
​
curl --request POST 'https://aisearch.cn-beijing.volces.com/api/v1/application/<application_id>/question_suggestions' \​
--header 'Authorization: Bearer <API_KEY>' \​
--header 'Content-Type: application/json' \​
--data '{}'​
​
响应参数​
​
参数​
类型​
说明​
request_id​
String​
请求唯一标识,用于问题排查。​
result​
Object​
成功响应结果。​
result.suggestions​
Array<String>​
推荐问题列表;无可用推荐或配置未开启时返回空数组。​
​
响应示例​
​
{​
"request_id": "68631400-6f90-4ab2-9881-b87bfc4b8f12",​
"result": {​
"suggestions": [​
"今天有哪些热门内容?",​
"给我推荐适合通勤看的内容",​
"最近有哪些科技新品?"​
]​
}​
}​
​
如果该应用线上配置关闭了开场推荐问题配置,该接口都将返回空的推荐问题列表。​
​
{​
"request_id": "68631400-6f90-4ab2-9881-b87bfc4b8f12",​
"result": {​
"suggestions": []​
}​
}​
​
​
最近更新时间:2026.09.30 15:37:55
这个页面对您有帮助吗?
有用
有用
无用
无用