API Guide
Updated: Nov 11, 2026
Base URLs, authentication, and common request and response headers for the Token Exchange API.
This guide covers the information that applies to all APIs. For the path, parameters, and response format of each API, see the API reference pages in the sidebar. For troubleshooting failed requests, see Error Handling.
1. Before You Begin
- Create an API Key in the Developer Center.
- Send requests using the base URL and headers described below.
2. Base URLs
| Region | Base URL (base_url) | Notes |
|---|---|---|
| Guangzhou | https://api.cysuo.com | Synchronous APIs: Chat and Images |
| Beijing | https://vod.bj.baidubce.com | Asynchronous APIs: Videos |
Append the API path to the base URL to form the request URL. For example, the Chat Completions endpoint is https://api.cysuo.com/v1/chat/completions.
3. Authentication
Authenticate each request by including your API Key in the Authorization header using the Bearer scheme:
Authorization: Bearer YOUR_API_KEYReplace YOUR_API_KEY with an API Key created in the Developer Center.
4. Common Request Headers
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Your API Key, in the format Bearer YOUR_API_KEY |
Content-Type | Conditional | Required for requests with a body. Usually application/json; multipart/form-data for image edits. |
X-Vod-Request-Id | No | Supported by Chat and Images APIs only. A custom request ID used for request tracing. If omitted, the system generates one. Must be 16–64 characters long, or a 400 error is returned. The same account cannot reuse a value within 8 hours, or a 409 error is returned. |
5. Common Response Headers
| Header | Always Returned | Description |
|---|---|---|
X-Vod-Task-Id | Yes | A globally unique task ID assigned to each request, for use in analytics, logging, and troubleshooting. Include this ID when contacting support. |
X-Vod-Request-Id | Yes | Returned by Chat and Images APIs only. Used for request tracing only. Do not use it for record-keeping or analytics. |
6. Example Request
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": "Hello, please introduce yourself."}] }'The -i option includes the response headers in the output, where you can find X-Vod-Task-Id and X-Vod-Request-Id.