## Basic tool info Tool name: openai/whisper-large-v3 Tool description: Whisper is a pre-trained model for automatic speech recognition (ASR) and speech translation. Trained on 680k hours of labelled data, Whisper models demonstrate a strong ability to generalise to many datasets and domains without the need for fine-tuning. Tool cover: https://cdn.wiro.ai/uploads/models/openai-whisper-large-v3-cover.png Tool categories: - tool - speech-to-text - whisper - audio - quick-showcase - grid-landscape Tool tags: - speech-to-text - whisper - recognition - audio - speech Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/openai/whisper-large-v3 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: inputAudioUrl label: input-audio-url help: input-audio-url-help type: text default: - name: language label: language help: language-help type: select default: auto options: - value: "auto" label: auto - value: "Afrikaans" label: Afrikaans - value: "Arabic" label: Arabic - value: "Azerbaijani" label: Azerbaijani - value: "Belarusian" label: Belarusian - value: "Bosnian" label: Bosnian - value: "Bulgarian" label: Bulgarian - value: "Catalan" label: Catalan - value: "Chinese" label: Chinese - value: "Croatian" label: Croatian - value: "Czech" label: Czech - value: "Danish" label: Danish - value: "Dutch" label: Dutch - value: "English" label: English - value: "Estonian" label: Estonian - value: "Finnish" label: Finnish - value: "French" label: French - value: "Galician" label: Galician - value: "German" label: German - value: "Greek" label: Greek - value: "Hebrew" label: Hebrew - value: "Hindi" label: Hindi - value: "Hungarian" label: Hungarian - value: "Icelandic" label: Icelandic - value: "Indonesian" label: Indonesian - value: "Italian" label: Italian - value: "Japanese" label: Japanese - value: "Kannada" label: Kannada - value: "Kazakh" label: Kazakh - value: "Korean" label: Korean - value: "Latvian" label: Latvian - value: "Lithuanian" label: Lithuanian - value: "Macedonian" label: Macedonian - value: "Malay" label: Malay - value: "Marathi" label: Marathi - value: "Maori" label: Maori - value: "Nepali" label: Nepali - value: "Norwegian" label: Norwegian - value: "Persian" label: Persian - value: "Polish" label: Polish - value: "Portuguese" label: Portuguese - value: "Romanian" label: Romanian - value: "Russian" label: Russian - value: "Serbian" label: Serbian - value: "Slovak" label: Slovak - value: "Slovenian" label: Slovenian - value: "Spanish" label: Spanish - value: "Swahili" label: Swahili - value: "Swedish" label: Swedish - value: "Tagalog" label: Tagalog - value: "Tamil" label: Tamil - value: "Thai" label: Thai - value: "Turkish" label: Turkish - value: "Ukrainian" label: Ukrainian - value: "Urdu" label: Urdu - value: "Vietnamese" label: Vietnamese - value: "Welsh" label: Welsh - name: maxNewTokens label: max-new-tokens help: max-new-tokens-help type: number default: 256 - name: chunkLength label: chunk-length help: chunk-length-help type: number default: 30 - name: batchSize label: batch-size help: batch-size-help type: float default: 8 - name: numSpeakers label: num-speakers help: num-speakers-help type: number default: 1 - name: diarization label: diarization help: diarization-help type: checkbox default: --diarization ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/openai/whisper-large-v3" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputAudioUrl": "input-speech-1-audio.mp3", "language": "auto", "maxNewTokens": 256, "chunkLength": 30, "batchSize": "8", "numSpeakers": 1, "diarization": "--diarization", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt', }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.