{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/fun-asr"}],"post":{"description":"[Core Function] Fun-ASR transcribes a single public audio file asynchronously. [Strengths] Hot-word vocabulary, optional speaker diarization, channel selection, and language hints. [Best For] Batch transcription of recordings up to 12 hours. [Limitations] Do NOT send more than one file per request. [Routing] Use fun-asr-mtl when multi-language optimization is preferred.","operationId":"funAsrAsync","requestBody":{"content":{"application/json":{"examples":{"minimal":{"summary":"Minimal request","value":{"file_url":"https://example.com/sample.wav"}}},"schema":{"properties":{"channel_id":{"default":[0],"description":"Audio track indices (0-based).","items":{"type":"integer"},"type":"array"},"diarization_enabled":{"default":false,"description":"Enable speaker diarization (mono audio; recommended ≤2h).","type":"boolean"},"file_url":{"description":"Public HTTP/HTTPS URL of the audio file (single file).","minLength":1,"pattern":"^https?://","type":"string"},"language_hints":{"description":"Language hints. When multiple values are provided, only the first is used.","items":{"enum":["zh","en","ja","ko","vi","th","id","ms","tl","hi","ar","fr","de","es","pt","ru","it","nl","sv","da","fi","no","el","pl","cs","hu","ro","bg","hr","sk"],"type":"string"},"type":"array"},"speaker_count":{"description":"Expected speaker count; only valid when diarization_enabled is true.","maximum":100,"minimum":2,"type":"integer"},"special_word_filter":{"description":"Sensitive word filter configuration string.","type":"string"},"vocabulary_id":{"description":"Optional hot-word vocabulary ID.","type":"string"}},"required":["file_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-fun-asr-001"},"model_id":"alibaba/fun-asr","status":"pending","task_id":"task-fun-asr-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-fun-asr-001","type":"string"}},"type":"object"},"model_id":{"description":"Model ID in provider/model format","example":"alibaba/fun-asr","type":"string"},"status":{"description":"Initial task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier for polling","example":"task-fun-asr-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":"Fun-ASR","x-mint":{"href":"alibaba/fun-asr"}}}