# Alibaba Cloud AiPodcast API

> Alibaba Cloud AiPodcast API on Apizie: 3 endpoints (Query the result of an AI podcast generation task, Submits an AI podcast generation task, version) 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://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-aipodcast`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/aipodcast
- Page: https://zieapi.vercel.app/api/cloud/aliyun-aipodcast
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-aipodcast/openapi.json

Alibaba Cloud OpenAPI for AiPodcast (aipodcast, version 2025-02-28). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Query the result of an AI podcast generation task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/podcast-task-result-query` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aipodcast.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace |
| taskId | string | yes | The unique task identifier |

### Submits an AI podcast generation task
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/podcast-task-submit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://aipodcast.cn-beijing.aliyuncs.com |
| workspaceId | string | yes | The ID of the Model Studio workspace for the current request |
| fileUrls | string | no | The URLs of source files (such as scripts) for the AI podcast generation task (JSON-encoded) |
| topic | string | no | The topic for generating the podcast content |
| counts | integer | no | The number of speakers |
| voices | string | no | The voices to use for podcast generation. The first voice in the array corresponds to the first speaker (JSON-encoded) |
| text | string | no | The source text for the AI podcast generation |
| sourceLang | string | no | The language for the generated podcast content, including both script and audio. The output will be in this language, regardless of the… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/version` (byok)

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/podcast-task-result-query" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud AiPodcast API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-aipodcast/podcast-task-result-query with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

### What is the status of the Alibaba Cloud AiPodcast API?
Needs your own provider key (bring your own key)