# Alibaba Cloud Data Transmission AI Service API

> Alibaba Cloud Data Transmission AI Service API on Apizie: 7 endpoints (Grants OSS PostObject direct upload authorization for callers to upload files directly to the specified…, Creates a document parsing task, Retrieves the result of a document parsing task, Queries the status of a document parsing task, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-dtsai/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-dtsai`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/dtsai
- Page: https://apizie.tech/api/cloud/aliyun-dtsai
- OpenAPI: https://apizie.tech/api/cloud/aliyun-dtsai/openapi.json

Alibaba Cloud OpenAPI for Data Transmission AI Service (dtsai, version 2026-04-01). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Grants OSS PostObject direct upload authorization for callers to upload files directly to the specified…
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/authorize-file-upload` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-beijing |
| AgentName | string | no | The source of the agent or client that initiates the call, such as codex, cursor, or openapi. The maximum length is 32 characters. This… |
| FileFormat | string | no | The format of the file to be uploaded |
| BatchSize | string | no | The number of OSS PostObject direct upload authorizations returned in this request |

### Creates a document parsing task
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/create-doc-parser-job` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID |
| FileUrl | string | no | The HTTP or HTTPS URL of the file to be parsed. The SDKs for various programming languages additionally provide a… |
| FileName | string | yes | The file name, which must include the file name extension |
| FileFormat | string | yes | The format of the input file. Valid values: pdf: PDF file. docx: Word file in .docx format. doc: Word file in .doc format. pptx: PPT file… |
| OutputFormat | string | yes | The output format of the parsing result. Valid values: markdown: Markdown format |
| OssFileUrl | string | no | The OSS file URL |
| ImageMode | string | no | The image carrier mode. Valid values: ignore, base64, placeholder, and oss (default, returns image links in the body) |
| ImageUnderstanding | string | no | Specifies whether to generate image understanding text. Valid values: full (default) and none |
| TableFormat | string | no | The table format. Valid values: html and markdown (default) |
| ResultType | string | no | The result return method. Valid values: content (default, Markdown body) and url (temporary OSS download URL) |
| AgentName | string | no | The agent name |
| ResponseMode | string | no | The response mode. Valid values: async (default, returns only JobId for the caller to poll) and sync (returns the parsing result… |
| MediaChunkStrategy | string | no | The chunking strategy. This parameter takes effect only for videos. Valid values: scene (default, chunks by scene) and interval (chunks at… |
| MediaChunkIntervalSeconds | integer | no | The media chunk interval in seconds. This parameter takes effect only for videos. Specifies the duration in seconds for each segment under… |
| MediaMinFrameBudget | integer | no | The minimum media frame budget. This parameter takes effect only for videos. Specifies the lower limit of the frame budget. Valid values:… |
| MediaFramesPerMinute | number | no | The number of frames extracted per minute. This parameter takes effect only for videos. Valid values: 0 to 30. A value of 0 disables the… |
| MediaMaxFrameBudget | integer | no | The maximum media frame budget. This parameter takes effect only for videos. Specifies the upper limit of the frame budget. Valid values:… |
| AudioWindowSeconds | integer | no | The chunk window length in seconds. This parameter takes effect only for audio-only files. Valid values: 10 to 600. Passing this parameter… |
| AsrLanguage | string | no | The Automatic Speech Recognition (ASR) language hint. Valid values: auto (default), zh, and en. When set to auto, the language field in… |
| FrameOutput | string | no | Specifies whether to output key frame images to OSS. This parameter takes effect only for videos. Default value: true. The media… |
| AudioClipOutput | string | no | Specifies whether to output segmented audio clips to OSS. Default value: true |
| ChunkSummary | string | no | Specifies whether to generate a one-sentence summary for each segment. Default value: true |
| GlobalSummary | string | no | Specifies whether to generate an overall summary. Default value: true |
| ParseScene | string | no | The parsing scene. This parameter takes effect only for document and image parsing. Valid values: general (default) and formula_ocr… |

### Retrieves the result of a document parsing task
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/describe-doc-parser-job-result` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID |
| JobId | string | yes | The document parsing task ID. You can obtain this ID by calling CreateDocParserJob |
| AgentName | string | no | The agent name |
| ResultType | string | no | The result type |

### Queries the status of a document parsing task
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/describe-doc-parser-job-status` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID |
| JobId | string | yes | The ID of the document parsing task. You can obtain the ID by calling CreateDocParserJob |
| AgentName | string | no | The agent name |

### Retrieves web page content
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/web-fetch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID |
| Url | string | yes | The URL of the target web page to fetch |
| OutputFormat | string | no | The output format. Valid values: markdown: Markdown format. html: HTML format. text: plain text format |
| AgentName | string | no | The agent name |

### Performs a web search
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/web-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |
| RegionId | string | yes | The region ID |
| Query | string | yes | The search query string |
| MaxResults | integer | no | The maximum number of results to return. Default value: 10. Valid values: 1 to 50 |
| UrlScopeMode | string | no | The domain scope mode. Valid values: allowOnly and deny. This parameter must be specified together with UrlScopeDomains, or both must be… |
| UrlScopeDomains | string | no | A comma-separated list of domain names. The total length cannot exceed 20,480 characters, and the list can contain up to 100 entries.… |
| AgentName | string | no | The agent name |

### version
`POST https://apizie.tech/v1/cloud:aliyun-dtsai/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://dtsai.cn-beijing.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-dtsai/authorize-file-upload" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Data Transmission AI Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-dtsai/authorize-file-upload with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Data Transmission AI Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Data Transmission AI Service itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Data Transmission AI Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-dtsai.

### What is the status of the Alibaba Cloud Data Transmission AI Service API?
Needs your own provider key (bring your own key)
