ShortyShorty
API Reference

Download a subtitle artifact

GET
/v1/subtitles/{jobId}/download

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.

Authorization

BearerApiKey
AuthorizationBearer <token>

A Shorty API key, sent as Authorization: Bearer <key>. An OAuth 2.1 access token issued to a connected app is also accepted on the same header.

In: header

Path Parameters

jobId*string
Length1 <= length

Query Parameters

kind?string
Default"srt"

Value in

  • "srt"
  • "vtt"
  • "ass"
  • "burned"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/subtitles/string/download"
{  "url": "string",  "expires_at": "string",  "kind": "srt",  "filename": "string"}