# Query podcast generation task status

Poll the current status of a podcast generation task.

- **processing**: Task in progress. Continue polling (recommended interval: 10-15 seconds; podcast generation typically takes several minutes).
- **succeeded**: Generation complete. The `audio_url` field contains a downloadable audio link (valid for 1 hour).
- **failed**: Generation failed. The `error` field contains the error message. Frozen amount is automatically refunded.

## GET /v1/audio/podcasts/{taskId}

> Query podcast generation task status

Poll the current status of a podcast generation task.

- **processing**: Task in progress. Continue polling (recommended interval: 10-15 seconds; podcast generation typically takes several minutes).
- **succeeded**: Generation complete. The `audio_url` field contains a downloadable audio link (valid for 1 hour).
- **failed**: Generation failed. The `error` field contains the error message. Frozen amount is automatically refunded.

### Authentication

`Authorization: Bearer tr-xxx`

### Path Parameters

- **taskId** `string` **(required)**  
  Task ID (the `id` field returned by `POST /v1/audio/podcasts`)

### Response

- **id** `string` **(required)**  
  Task ID
- **model** `string` **(required)**  
  Model ID used
- **status** ``processing` | `succeeded` | `failed` | `cancelled`` **(required)**  
  Task status
- **audio_url** `string`  
  Podcast audio download URL (valid for 1 hour). Only present when `status: succeeded`
- **audio_duration** `number`  
  Total podcast duration (seconds). Only present when `status: succeeded`
- **usage** `object`  
  Token usage. Only present when `status: succeeded`
- **usage.input_text_tokens** `integer`  
  Input text token count
- **usage.output_audio_tokens** `integer`  
  Output audio token count
- **error** `string`  
  Error message. Only present when `status: failed`
- **created_at** `string` **(required)**  
  Task creation time
- **updated_at** `string` **(required)**  
  Task last updated time

### Error Codes

- `401`: 
- `404`: Task not found or does not belong to the current user
- `429`: