{ "openapi": "3.0.1", "info": { "title": "Subtitle Generator: Video & Audio to SRT and VTT Subtitles", "description": "Generate ready-to-use subtitle files from any video or audio. Paste a file link, a Google Drive or Dropbox share link, or upload a file, and download SRT and VTT subtitles with clean line breaks and accurate timing. 99+ languages, pay per minute.", "version": "0.1", "x-build-id": "nDxh1zzpI6SMBQVda" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/spokentext~subtitle-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-spokentext-subtitle-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/spokentext~subtitle-generator/runs": { "post": { "operationId": "runs-sync-spokentext-subtitle-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/spokentext~subtitle-generator/run-sync": { "post": { "operationId": "run-sync-spokentext-subtitle-generator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "Video or audio file URLs", "type": "array", "description": "Direct links to video or audio files (mp4, mov, webm, mp3, m4a, wav...), or Google Drive and Dropbox share links. Share links must be open to anyone with the link.", "items": { "type": "string" } }, "file": { "title": "Or upload a file", "type": "string", "description": "Upload one video or audio file from your computer instead of pasting a link." }, "language": { "title": "Spoken language (optional)", "type": "string", "description": "Two-letter code of the language spoken in the file (en, fr, es, de...). Leave empty to detect it automatically. Subtitles are written in the spoken language." }, "maxCharsPerLine": { "title": "Maximum characters per line", "minimum": 15, "maximum": 100, "type": "integer", "description": "42 is the broadcast standard for landscape video. Use about 20 to 25 for vertical video (Shorts, Reels, TikTok).", "default": 42 }, "maxLines": { "title": "Maximum lines per subtitle", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many lines a single subtitle may use.", "default": 2 }, "maxSecondsPerSubtitle": { "title": "Maximum seconds per subtitle", "minimum": 1, "maximum": 15, "type": "integer", "description": "A subtitle is split when it would stay on screen longer than this.", "default": 6 }, "includeSrt": { "title": "Also include the SRT text in the results", "type": "boolean", "description": "Adds the SRT content as a text field in each result, convenient when calling the Actor from the API.", "default": false }, "maxMinutesPerFile": { "title": "Maximum minutes per file", "minimum": 1, "type": "integer", "description": "Longer files are cut at this length, so a single run can never cost more than you expect.", "default": 300 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }