---
title: "Get Task"
method: GET
path: "/v1/tts/max/{id}"
tags: ["Voice AI Beta — Max"]
---

# Get Task

`GET /v1/tts/max/{id}`

## Request

- Base URL: `https://genaipro.io/api`
- URL: `https://genaipro.io/api/v1/tts/max/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/genaipro/apis/genaipro-api/docs/v1/tts/max/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Task detail, including original `content` and settings. When `status` is `completed` the audio URL is in `result`.
> **Rate limit:** 120 requests/minute

## Path parameters

- `id` string, required

## Response `200`

Task detail

- TtsMaxTaskDetail: Voice AI Beta task (list item). This is also the payload of the `tts_<provider>_task_updated` WebSocket event and of the `callback_url` webhook POST.
  - `id` string: Task ID
  - `title` string: Task title
  - `status` 'pending' | 'cloning' | 'queued' | 'processing' | 'merging' | 'process_merging' | 'completed' | 'failed': Voice AI Beta task lifecycle: `pending` → `cloning` (clone flow only) → `queued` → `processing` → `merging` → `process_merging` → `completed` | `failed`.
  - `provider` string: Provider: `nova`, `lyra`, `sirius`, `vega`, `max` (other values may appear as new providers launch)
  - `result` string: Audio file URL (empty until `completed`). Public; deleted about 90 days after creation (then `404`) — download it yourself.
  - `total_length` integer: Billable characters (encoder units ≈ UTF-8 bytes — see the Voice AI Beta tag)
  - `process_percentage` integer: Progress percentage
  - `error` string: Failure reason (only when `status` is `failed`)
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `content` string: Original input text (SRT tasks — the SRT content)
  - `voice_id` string: Preset voice used (empty when a clone was used)
  - `voice_asset_id` string: Voice clone used (only present on clone tasks)
  - `format` string
  - `tts_model` string
  - `language` string: ISO-639-1 code (empty = automatic detection)
  - `speed` number
  - `volume` number
  - `pitch` integer
  - `subtitle_available` boolean: Whether `POST /v1/tts/max/{id}/export-subtitle` can build a subtitle for this task

## Other responses

- `404`: Not found (ids from other providers also return 404 here)
- `429`: Rate limit exceeded

## Changes

- **2026-10-29** `8e065c159192`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/max/:id/get.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) - [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/264ca07ba262?raw)