---
title: "Export Subtitle"
method: POST
path: "/v1/tts/max/{id}/export-subtitle"
tags: ["Voice AI Beta — Max"]
---

# Export Subtitle

`POST /v1/tts/max/{id}/export-subtitle`

## Request

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

Build an SRT subtitle file timed to the generated audio of a `completed` task (available while the task's `subtitle_available` is `true`). The body is optional; omitted or `0` values use the defaults.
> **Rate limit:** 30 requests/minute

## Path parameters

- `id` string, required

## Request body

- object
  - `max_characters_per_line` integer
  - `max_lines_per_cue` integer
  - `max_seconds_per_cue` integer

## Response `200`

Subtitle file created

- object
  - `subtitle` string: URL of the `.srt` file (public; deleted about 90 days after the task was created)
  - `cues` integer: Number of cues in the file

## Other responses

- `400`: Task is not completed
- `404`: Task not found
- `422`: This task has no subtitle timing data
- `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/export-subtitle/post.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)