{ "openapi": "3.0.1", "info": { "title": "Hebrew & Arabic Audio Transcription + RTL Subtitles (Whisper)", "description": "Transcribe Hebrew, Arabic and 90+ languages from your audio/video files to text, timestamps and RTL-correct SRT/VTT subtitles. Hebrew uses ivrit.ai's Hebrew-tuned Whisper. Runs fully inside Apify - no third-party API key, no scraping.", "version": "1.0", "x-build-id": "nUmtbVgit4Wp0Otg5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/harushlabs~hebrew-arabic-audio-transcription/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-harushlabs-hebrew-arabic-audio-transcription", "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/harushlabs~hebrew-arabic-audio-transcription/runs": { "post": { "operationId": "runs-sync-harushlabs-hebrew-arabic-audio-transcription", "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/harushlabs~hebrew-arabic-audio-transcription/run-sync": { "post": { "operationId": "run-sync-harushlabs-hebrew-arabic-audio-transcription", "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": { "mediaUrls": { "title": "Audio / video URLs", "type": "array", "description": "Direct links to audio or video files you own or are allowed to process (MP3, WAV, M4A, OGG, OPUS, FLAC, MP4, MOV, WEBM...). The Actor does not download from YouTube or social networks.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "language": { "title": "Spoken language", "enum": [ "auto", "he", "ar", "en", "ru", "fr", "es", "am", "yi" ], "type": "string", "description": "Hebrew uses ivrit.ai's Hebrew-tuned Whisper model; other languages use Whisper large-v3-turbo. Setting the language explicitly is faster and more accurate than auto-detection.", "default": "auto" }, "translateToEnglish": { "title": "Translate to English", "type": "boolean", "description": "Output an English translation instead of the original-language transcript (Whisper translate task).", "default": false }, "outputFormats": { "title": "Output fields", "type": "array", "description": "Which outputs to include in each dataset item.", "items": { "type": "string", "enum": [ "text", "segments", "srt", "vtt" ], "enumTitles": [ "Plain text", "Timestamped segments", "SRT subtitles", "WebVTT subtitles" ] }, "default": [ "text", "segments", "srt", "vtt" ] }, "wordTimestamps": { "title": "Word-level timestamps", "type": "boolean", "description": "Adds per-word timings (slower, ~10-20%). Also improves subtitle splitting.", "default": false }, "skipSilence": { "title": "Skip silence (VAD)", "type": "boolean", "description": "Voice activity detection removes long silences and reduces hallucinated text.", "default": true }, "vocabularyHint": { "title": "Vocabulary hint", "type": "string", "description": "Optional names, terms or spelling you expect (e.g. product names, people, places). Max 800 characters." }, "subtitleMaxCharsPerLine": { "title": "Subtitle max characters per line", "minimum": 16, "maximum": 80, "type": "integer", "description": "Long segments are split into several cues so each line stays within this length (42 is the common broadcast standard).", "default": 42 }, "subtitleMaxLines": { "title": "Subtitle max lines per cue", "minimum": 1, "maximum": 3, "type": "integer", "description": "Maximum lines per subtitle cue.", "default": 2 }, "rtlSubtitleMode": { "title": "RTL subtitle fix", "enum": [ "rlm", "embed", "none" ], "type": "string", "description": "Keeps punctuation and numbers on the correct side when Hebrew/Arabic subtitles are displayed.", "default": "rlm" }, "saveSubtitleFiles": { "title": "Save .srt/.vtt files", "type": "boolean", "description": "Also store subtitle files in the run's key-value store for direct download.", "default": true }, "maxMinutesPerFile": { "title": "Max minutes per file", "minimum": 1, "maximum": 600, "type": "integer", "description": "Longer files are transcribed up to this limit (and flagged as truncated).", "default": 180 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Files larger than this are skipped (status: error).", "default": 500 } } }, "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 } } } } } } } } } }