GET /v1/subtitles/{jobId}/download
Download a subtitle artifact — Shorty API
Returns a short-lived presigned URL for a completed subtitle job’s artifact. Use `?kind=` to pick srt (default), vtt, ass, or the burned-in mp4. A job that is not complete returns 409; a missing or foreign job id returns 404; an artifact kind not generated for the job returns 404.
GET /v1/subtitles/{jobId}/downloadReturns a short-lived presigned URL for a completed subtitle job’s artifact. Use ?kind= to pick srt (default), vtt, ass, or the burned-in mp4. A job that is not complete returns 409; a missing or foreign job id returns 404; an artifact kind not generated for the job returns 404.
Authentication
Requires a Bearer credential — a shk_live_ API key or an OAuth 2.1 access token with the scope for this resource. See Authentication.
Parameters
| Name | In | Required | Description |
|---|---|---|---|
jobId | path | Yes | — |
kind | query | No | — |
Example request
curl -X GET https://aishorty.com/v1/v1/subtitles/{jobId}/download?kind=srt \
-H "Authorization: Bearer shk_live_your_key"Response · 200
| Field | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Short-lived presigned URL to download the subtitle artifact. |
expires_at | string | Yes | ISO-8601 UTC timestamp the presigned URL expires. |
kind | "srt" | "vtt" | "ass" | "burned" | Yes | Artifact kind: srt/vtt/ass subtitle file, or the burned-in mp4. |
filename | string | Yes | Suggested download filename. |
Errors
On failure this endpoint returns an RFC 9457 problem body. Possible statuses:
400401403404409429500
Switch on the problem code, not the status. See the error reference for every code and how to fix it.