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

# Get Task

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

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

## Path parameters

- `id` string, required

## Response `200`

Task detail

- TtsSiriusTaskDetail — 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` (other values may appear as new providers launch)
  - `result` string — Audio file URL (empty until `completed`)
  - `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
  - `voice` string — Preset voice used (empty when a personal voice was used)
  - `voice_asset_id` string — Voice clone used (only present on clone tasks)
  - `voice_design_id` string — Voice design used (only present on design tasks)
  - `style` string — Style instructions applied (only present when provided)
  - `format` string

## Other responses

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

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) · [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/genaipro/genaipro-api/revisions/91f814eaecbd/schema)