调用指南
更新时间：2026-11-11
调用词元所 API 的服务地址、鉴权方式、公共请求头与公共响应头。
本文介绍所有接口通用的调用信息。各接口的路径、请求参数和响应结构，见左侧各接口文档；调用失败时的排查方法见错误处理。
1. 接入准备
- 在开发者中心创建 API Key。
- 按下文拼接服务地址和请求头，发起调用。
2. 服务地址
| 地域 | 服务地址（base_url） | 备注 |
|---|---|---|
| 广州 | https://api.cysuo.com | 同步接口：聊天（Chat）、图片（Images） |
| 北京 | https://vod.bj.baidubce.com | 异步接口：视频（Videos） |
完整请求地址为服务地址拼接接口路径，例如 Chat Completions 接口为 https://api.cysuo.com/v1/chat/completions。
3. 鉴权
调用 API 时，在请求头 Authorization 中携带 API Key，格式为 Bearer、一个空格、API Key：
Authorization: Bearer YOUR_API_KEY请将 YOUR_API_KEY 替换为在开发者中心创建的 API Key。
4. 公共请求头
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | 鉴权信息，格式为 Bearer YOUR_API_KEY |
Content-Type | 有请求体时 | 请求体格式，通常为 application/json；图片编辑接口为 multipart/form-data。GET 等无请求体的接口无需传 |
X-Vod-Request-Id | 否 | 仅聊天（Chat）、图片（Images）接口支持。允许用户指定请求 ID，仅用于追踪请求链路，通常无需指定，系统会自动生成。指定时长度须为 16～64 个字符，否则返回 400；同一账号 8 小时内不能重复使用同一个值，否则返回 409 |
5. 公共响应头
| Header | 必返 | 说明 |
|---|---|---|
X-Vod-Task-Id | 是 | 每条请求生成的全局唯一任务 ID，可用于数据统计、日志和排查问题。排查问题时，请提供 X-Vod-Task-Id。 |
X-Vod-Request-Id | 是 | 仅聊天（Chat）、图片（Images）接口返回。仅用于追踪请求链路，切勿用于数据记录和统计 |
6. 调用示例
curl -i https://api.cysuo.com/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "你好，请介绍一下你自己。"}] }'-i 会打印响应头，可从中看到 X-Vod-Task-Id 和 X-Vod-Request-Id。