{"openapi":"3.1.0","info":{"title":"Qwen3 ASR API","description":"中文短句整段与流式识别。HTTP 用 Bearer Token；WebSocket 协议见 /api-docs。","version":"1.0.0"},"paths":{"/healthz":{"get":{"summary":"进程存活检查","operationId":"health_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResult"}}}}}}},"/readyz":{"get":{"summary":"模型就绪与容量状态","operationId":"ready_readyz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyResult"}}}},"401":{"description":"Token 缺失或错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"连接 peer 不在白名单","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"模型加载中或加载失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyResult"}}}}},"security":[{"BearerAuth":[]}]}},"/v1/audio/transcriptions":{"post":{"summary":"整段 PCM WAV 转写","operationId":"transcriptions_v1_audio_transcriptions_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_transcriptions_v1_audio_transcriptions_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResult"}}}},"400":{"description":"音频格式或内容无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Token 缺失或错误","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"连接 peer 不在白名单","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"408":{"description":"上传超时","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"409":{"description":"已有识别任务","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"413":{"description":"上传体积超过限制","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"500":{"description":"模型推理失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"模型尚未就绪","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerAuth":[]}]}}},"components":{"schemas":{"ApiError":{"properties":{"error":{"type":"string","title":"Error"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["error"],"title":"ApiError"},"Body_transcriptions_v1_audio_transcriptions_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_transcriptions_v1_audio_transcriptions_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResult":{"properties":{"status":{"type":"string","const":"alive","title":"Status"}},"type":"object","required":["status"],"title":"HealthResult"},"ReadyResult":{"properties":{"status":{"type":"string","enum":["ready","loading"],"title":"Status"},"busy":{"type":"boolean","title":"Busy"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status","busy"],"title":"ReadyResult"},"TranscriptionResult":{"properties":{"text":{"type":"string","title":"Text","description":"完整识别文本；当前固定 Chinese，无时间戳"},"audio_ms":{"type":"integer","title":"Audio Ms","description":"提交的音频时长，毫秒"},"inference_ms":{"type":"number","title":"Inference Ms","description":"服务端推理调用耗时，毫秒；不含上传时间"}},"type":"object","required":["text","audio_ms","inference_ms"],"title":"TranscriptionResult"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"共享 API Token，请放在 Authorization 请求头"}}},"servers":[{"url":"https://asr.talent-map.com"}],"externalDocs":{"description":"HTTP 与 WebSocket 完整调用文档","url":"https://asr.talent-map.com/api-docs"}}