# 创建播客生成任务

提交播客生成任务，立即返回任务 ID。播客生成为异步操作，需通过
`GET /v1/audio/podcasts/{taskId}` 轮询任务状态。

系统会对输入文本进行分析总结，生成双人对话播客音频。支持四种模式：
- **长文本总结**：传入 `input_text`，对长文本进行分析总结生成播客
- **URL 解析**：传入 `input_url`，对网页链接内容生成播客
- **联网搜索**：传入 `prompt_text`，对特定话题联网搜索后生成播客
- **对话文本**：传入 `nlp_texts`，根据预设的对话文本直接生成播客音频

计费方式：按 Token 计费（输入文本 Token + 输出音频 Token），提交时冻结预估金额，完成后按实际用量结算。

## POST /v1/audio/podcasts

> 创建播客生成任务

提交播客生成任务，立即返回任务 ID。播客生成为异步操作，需通过
`GET /v1/audio/podcasts/{taskId}` 轮询任务状态。

系统会对输入文本进行分析总结，生成双人对话播客音频。支持四种模式：
- **长文本总结**：传入 `input_text`，对长文本进行分析总结生成播客
- **URL 解析**：传入 `input_url`，对网页链接内容生成播客
- **联网搜索**：传入 `prompt_text`，对特定话题联网搜索后生成播客
- **对话文本**：传入 `nlp_texts`，根据预设的对话文本直接生成播客音频

计费方式：按 Token 计费（输入文本 Token + 输出音频 Token），提交时冻结预估金额，完成后按实际用量结算。

### Authentication

`Authorization: Bearer tr-xxx`

### Request Body

Content-Type: `application/json`

- **model** `string` **(required)**  
  播客模型 ID，可通过 `GET /v1/models` 过滤 `type: podcast` 获取
- **input_text** `string`  
  待播客合成的长文本（与 `input_url`、`prompt_text`、`nlp_texts` 四选一），上限 32K 字符
- **input_url** `string`  
  网页或文件链接（支持 PDF、DOC、TXT），系统自动提取内容生成播客
- **prompt_text** `string`  
  搜索话题关键词，系统联网搜索后生成播客
- **nlp_texts** `object[]`  
  预设的对话文本列表，每轮指定发言人和文本，直接合成为播客音频
- **nlp_texts[].text** `string` **(required)**  
  对话文本（单轮不超过 300 字符）
- **nlp_texts[].speaker** `string` **(required)**  
  发音人 ID
- **speakers** `string[]`  
  指定两个发音人 ID。推荐使用同系列配对：
- **audio_format** ``mp3` | `ogg_opus` | `pcm` | `aac`` (default: `mp3`)  
  输出音频格式
- **sample_rate** ``16000` | `24000` | `48000`` (default: `24000`)  
  采样率
- **speech_rate** `integer` (default: `0`)  
  语速，范围 [-50, 100]。100 = 2.0 倍速，-50 = 0.5 倍速
- **use_head_music** `boolean` (default: `true`)  
  是否使用开头音效
- **use_tail_music** `boolean` (default: `false`)  
  是否使用结尾音效

### Response

- **id** `string` **(required)**  
  任务 ID（用于轮询状态）
- **model** `string` **(required)**  
  使用的模型 ID
- **status** ``processing`` **(required)**  
  初始任务状态，固定为 `processing`
- **created_at** `string` **(required)**  
  任务创建时间

### Error Codes

- `400`: 
- `401`: 
- `402`: 
- `429`: 
- `502`: