免费下载
文档中心/ 百度搭子/ 企业版使用指南/ API参考/ 认证鉴权

认证鉴权

百度搭子 Agent API 使用 API Key 识别调用方身份。API Key 是调用 API 服务的鉴权凭证，请妥善保管并定期更换，以避免安全风险或资金损失。

创建 API Key

  1. 登录百度搭子企业版管理平台，进入 API 集成 > API Key。

image.png

  1. 创建 API Key，并根据实际业务选择权限范围。

image.png

  1. 复制完整的 API Key，通过服务端环境变量或密钥管理系统保存。

image.png


请求鉴权

在 HTTP 请求 Header 中设置：

Http 
1Authorization: Bearer <YOUR_API_KEY>

Bearer 与 API Key 之间使用一个空格。Authorization 为必填请求头。

根据请求类型设置对应请求头：

请求类型 Header
JSON 请求 Content-Type: application/json
文件上传 Content-Type: multipart/form-data（由客户端自动生成 boundary）
SSE 订阅 Accept: text/event-stream

提示：不要将 API Key 放在 URL 查询参数、请求体、日志或错误信息中。

调用示例

GET 请求

Bash 
1curl "https://api.dumate.cn/api/v1/agents" \
2  --request GET \
3  --header "Authorization: Bearer <YOUR_API_KEY>"

POST JSON 请求

Bash 
1curl "https://api.dumate.cn/api/v1/sessions" \
2  --request POST \
3  --header "Authorization: Bearer <YOUR_API_KEY>" \
4  --header "Content-Type: application/json" \
5  --data '{"agent":{"id":"<AGENT_ID>"}}'

文件上传

Bash 
1curl "https://api.dumate.cn/api/v1/files" \
2  --request POST \
3  --header "Authorization: Bearer <YOUR_API_KEY>" \
4  --form "file=@/absolute/path/to/agent-file.txt"

SSE 事件流

Bash 
1curl -N "https://api.dumate.cn/api/v1/sessions/<SESSION_ID>/events/stream" \
2  --header "Authorization: Bearer <YOUR_API_KEY>" \
3  --header "Accept: text/event-stream"