联网问答Agent
联网问答Agent
文档指南
请输入
- 文档首页
联网问答AgentAPI参考智能体API认证方式
复制全文
下载 pdf智能体API认证方式
文档反馈
问问助手联网问答Agent的API接口提供 API Key 接入和 Access Key接入两种方式，两种接入方式有不同的URL。
API Key接入
此接入方式基于火山引擎访问控制的 API Key 鉴权。
- 开通账号权限后，可获取 API Key 进行验签，详情请参见：API 密钥(Access Key 与 API Key)--访问控制-火山引擎
- 签名构造
API Key 签名鉴权方式要求在 HTTP 请求 header 中按如下方式添加 Authorization:
注意：
- 若使用主账号接入，需要配置API Key的产品权限时，请选择“联网问答Agent”产品。
- 若使用子账号接入，需要首先登录控制台，开通接口访问权限；否则会报错invalid_api_key错误。
- 开通接口访问权限步骤：
- 使用火山引擎主账号，登录控制台；
- 进入 访问控制用户管理 页面，找到需要添加权限的子账号，点击添加权限按钮，进入子账号权限管理界面；
- 在策略搜索栏输入“AskEchoFullAccess”权限，选中并提交。
- 若有多个子账号访问，需对每个子账号进行相应权限配置。
- 不支持自定义策略中条件（Condition）策略权限。
- 若使用 API Key 接入，接口超时时间为120s。
Access Key接入
此接入方式基于火山引擎访问控制的AK/SK鉴权，统一使用 ServiceName=ask_echo
- 接口验签及请求公共参数逻辑遵循火山引擎官网的统一规范，详情请参见：签名方法--API签名调用指南-火山引擎；
- 开通账号权限后，可获取 Access Key 进行验签，详情请参见：Access Key(密钥)管理--API访问密钥(Access Key)-火山引擎。
注意：
- 若使用主账号接入，可跳过此步骤；(使用主账号有权限过大的风险，不建议直接使用)
- 若使用子账号接入，需要首先登录控制台，开通接口访问权限；否则会报错100013:AccessDenied错误。
- 开通接口访问权限步骤：
- 使用火山引擎主账号，登录控制台；
- 进入 访问控制用户管理 页面，找到需要添加权限的子账号，点击添加权限按钮，进入子账号权限管理界面；
- 在策略搜索栏输入“AskEchoFullAccess”权限，选中并提交。
- 若有多个子账号访问平台，需对每个子账号进行相应权限配置。
- 若使用 Access Key 接入，请求体整体长度不能超过8M，接口超时时间为30s。
最近更新时间：2026.08.11 21:21:40
这个页面对您有帮助吗？
有用
有用
无用
无用