> For the complete documentation index, see [llms.txt](https://nsclouds.gitbook.io/aillm.nscloud.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nsclouds.gitbook.io/aillm.nscloud.ai/api-reference-cn/yin-pin-zhuan-lu/dashscope.md).

# DashScope

### 1. 概述

DashScope 在当前环境中提供的音频转写能力。

{% hint style="success" %}
本接口提供与 OpenAI Audio Transcriptions 兼容的请求路径。不同厂家和模型的实际能力可能不同。
{% endhint %}

**模型列表：**

* `qwen3-asr-flash`

### 2. 接口详情

## 音频转录

> 提供与 OpenAI Audio Transcriptions 兼容的音频转写接口。具体支持的能力因模型而异。

```json
{"openapi":"3.1.0","info":{"title":"NSCloud AI API 文档","version":"1.11.0"},"tags":[{"name":"audio_transcriptions_dashscope","description":"DashScope 的音频转录 API"}],"servers":[{"url":"https://aillm.nscloud.ai","description":"国际服务器"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"http","scheme":"bearer","description":"使用 Bearer 令牌进行认证，格式：'Bearer YOUR_SECRET_TOKEN'"}},"schemas":{"CreateTranscriptionRequest":{"type":"object","description":"音频转录请求体。","properties":{"model":{"type":"string","description":"要调用的模型 ID。"},"file":{"type":"string","format":"binary","description":"待转录的音频文件。"},"language":{"type":"string","description":"音频语言代码，可选。"},"prompt":{"type":"string","description":"可选提示词，用于约束转录风格或术语。"},"response_format":{"type":"string","description":"转录结果返回格式。","enum":["json","text","srt","verbose_json","vtt"],"default":"json"},"temperature":{"type":"number","description":"采样温度。","default":0},"timestamp_granularities":{"type":"array","description":"response_format 为 verbose_json 时返回的时间戳粒度。","items":{"type":"string","enum":["word","segment"]}}},"required":["model","file"]},"TranscriptionResponse":{"type":"object","description":"JSON 格式的转录响应。","properties":{"text":{"type":"string","description":"转录后的文本内容。"}}},"ErrorResponse":{"type":"object","description":"错误响应。","properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}}},"ErrorDetail":{"type":"object","description":"错误详情对象。","properties":{"message":{"type":"string","description":"错误说明。"},"type":{"type":"string","description":"错误类型。"},"param":{"description":"与错误相关的参数名。","type":["string","null"]},"code":{"description":"错误码。","type":["string","null"]}}}},"responses":{"ErrorResponse":{"description":"错误响应","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/audio/transcriptions":{"post":{"tags":["audio_transcriptions_dashscope"],"summary":"音频转录","description":"提供与 OpenAI Audio Transcriptions 兼容的音频转写接口。具体支持的能力因模型而异。","operationId":"createTranscription_dashscope","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateTranscriptionRequest"}}}},"responses":{"200":{"description":"成功响应","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}},"application/x-srt":{"schema":{"type":"string","description":"SRT 字幕格式的转录。"}},"text/plain":{"schema":{"type":"string","description":"纯文本格式的转录。"}}}},"400":{"$ref":"#/components/responses/ErrorResponse"},"401":{"$ref":"#/components/responses/ErrorResponse"},"429":{"$ref":"#/components/responses/ErrorResponse"}}}}}}
```