{"servers":[{"url":"https://api.modellix.ai/api/v1/openai/whisper-1"}],"post":{"description":"[Core Function] OpenAI Whisper transcribes a single public audio URL into text via an async task. [Strengths] Multiple output formats (verbose_json with word/segment timestamps, plain text, SRT, VTT), optional language and prompt biasing. [Best For] Meeting notes, podcasts, captions, and batch audio-to-text. [Limitations] Do NOT use file upload; URL-only input (audio up to 25 MB). Prefer verbose_json when you need duration or timestamps. [Routing] Use whisper-1 for OpenAI Whisper quality with URL-based audio.","operationId":"openaiWhisperSTT","requestBody":{"content":{"application/json":{"examples":{"basic":{"summary":"Minimal request","value":{"url":"https://cdn.example.com/meeting.mp3"}},"verbose":{"summary":"Word and segment timestamps","value":{"response_format":"verbose_json","timestamp_granularities":["word","segment"],"url":"https://cdn.example.com/meeting.mp3"}}},"schema":{"additionalProperties":false,"properties":{"language":{"description":"ISO-639-1 language hint for transcription.","type":"string"},"prompt":{"description":"Optional text to guide the model's style or continue a previous segment.","type":"string"},"response_format":{"default":"verbose_json","description":"Output format. verbose_json recommended for duration and timestamps.","enum":["json","text","srt","verbose_json","vtt"],"type":"string"},"temperature":{"default":0,"description":"Sampling temperature; higher values increase randomness.","maximum":1,"minimum":0,"type":"number"},"timestamp_granularities":{"description":"Timestamp detail levels. Requires response_format=verbose_json when non-empty.","items":{"enum":["word","segment"],"type":"string"},"type":"array"},"url":{"description":"Public http(s) URL of the audio file (max 25 MB).","minLength":1,"pattern":"^https?://","type":"string"}},"required":["url"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"code":0,"data":{"get_result":{"method":"GET","url":"https://api.modellix.ai/api/v1/tasks/task-whisper-001"},"model_id":"openai/whisper-1","status":"pending","task_id":"task-whisper-001"},"message":"success"},"schema":{"description":"Response object for asynchronous task submission.","properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Task submission details. Poll GET /api/v1/tasks/{task_id} until status is success; the transcription appears in result.resources. See Common API: Query Task Result.","properties":{"get_result":{"description":"Endpoint to query the task result. See Common API: Query Task Result.","properties":{"method":{"example":"GET","type":"string"},"url":{"example":"https://api.modellix.ai/api/v1/tasks/task-whisper-001","type":"string"}},"type":"object"},"model_id":{"description":"Model ID in provider/model format","example":"openai/whisper-1","type":"string"},"status":{"description":"Initial task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for polling","example":"task-whisper-001","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully. Poll GET /api/v1/tasks/{task_id} until the task completes; the transcription result is returned on the task result."},"400":{"description":"Invalid parameters"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limited"},"500":{"description":"Internal server error"}},"summary":"Whisper STT","x-mint":{"href":"openai/whisper-1"}}}