Alibaba

Qwen Audio 3.0 TTS

qwen-audio-3.0-tts-plus

阿里通义托管式多语言语音合成系列，含低延迟 Flash 与高音质 Plus 两档，支持用自然语言指令控制情绪与表达风格

qwen-audio-3.0-tts-flash qwen-audio-3.0-tts-plus

试用 qwen-audio-3.0-tts-plus

输入

合成指令

作品灵感

查看全部作品

输出

audio

填写参数并生成，结果会显示在这里。

价格

qwen-audio-3.0-tts-plus 每千字符

单价	$0.040

定位简介

Qwen Audio 3.0 TTS Plus 是阿里 Qwen Audio 3.0 TTS 系列中面向高质量语音生成的托管模型，通过 HiAPI.ai 统一接口调用，输入文本即可输出自然、保真的语音。它支持多语言合成长文本，可用自然语言指令引导情绪与表达风格，并提供语速、音高、音量、采样率与输出格式等参数控制。适合对音质与音色表现要求高于实时响应的有声内容、课程朗读、客服播报与多语言配音等生成式场景。

核心亮点

面向音质优先的 Plus 档位——与同系列 Flash 相比更侧重自然度与音色保真，适合非强实时的离线或批量语音生产。
指令化控制表达风格——可通过合成指令描述情绪与表达方式，减少逐段试听和后期修音的返工。
单次可合成两万字符文本——单任务最多接受两万 Unicode 码点，长文可整段提交，减少分段拼接与边界处理。
输出参数可精细调校——语速、音高与音量均支持区间调节，采样率与容器格式可选，便于对接下游音频管线。

能力说明

多语言语音合成：支持十余种语言的合成提示，一次接入即可为中文、英文、日韩及多语种内容生成语音，降低多语内容的接入成本。

自然语言指令引导风格：通过合成指令描述语气、情绪与表达方式，让同一文本产出不同播讲风格，无需更换音色或后期处理。

音频参数调控：可设置语速、音高、音量与输出采样率，并按需选择 mp3、wav、pcm、opus 等输出格式，方便直接对接播放或转码链路。

确定性合成：支持设定随机种子，便于对同一文本复现一致的合成结果，利于回归测试与内容版本管理。

Opus 码率可调：输出 Opus 时可指定码率，在带宽敏感的分发场景中平衡音质与文件体积。

适用场景

有声内容创作者的文稿转语音——将长篇文章或章节文本一次提交，产出可直接上架播客与有声书平台的音频，减少分段合成与拼接工作。
在线教育机构的课程讲稿朗读——把课程讲稿合成为风格统一的讲解音频，用于课件配音与复习音频，缩短录制周期。
客服团队的播报话术生成——将标准化话术文本转为语音素材，用于呼叫中心与自助服务渠道的固定播报内容。
内容团队的跨语言配音——借助语言提示为多语版本稿件生成对应语音，用于产品介绍与营销素材的本地化。

限制与选型建议

Plus 档位以音质为先，速度不及同系列 Flash，不适合对首包延迟敏感的实时对话场景，这类需求应优先考虑 Flash。当前仅提供两个系统音色，且不支持基于文本描述设计音色；声音克隆能力并非所有渠道开放，接入前需确认。此外它是托管合成服务，不提供自托管部署，若需要本地化部署或深度定制模型，应另作选型。

近期更新

查看更新日志 →

模型上新 qwen-audio-3.0-tts-flash 上线
模型上新 qwen-audio-3.0-tts-plus 上线：文本转语音，$0.04/千字符

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：qwen-audio-3.0-tts-plus

routestring可选

当前固定值：default

inputobject必填

qwen-audio-3.0-tts-plus 和线路 default 的业务参数对象，见下方参数表。

ratenumber可选默认值: 1min 0.5max 2

语音语速倍率，取数值型；默认 1。

seedinteger可选默认值: 0min 0max 65535

确定性合成随机种子，取整数；默认 0，相同种子下合成结果可复现。

textstring必填minLength 1maxLength 20000

待合成的文本内容；单任务最多接受 20,000 个 Unicode 码点，上游计费时 CJK 表意文字按两个字符计、其他字符按一个字符计。

pitchnumber可选默认值: 1min 0.5max 2

音调倍率，取数值型；默认 1。

voicestring必填默认值: "longanlingxin"

使用的官方系统音色，取字符串，Plus 档位支持的音色；默认 longanlingxin。

可选项：longanlingxinlonganlufeng

formatstring可选默认值: "mp3"

输出音频的封装格式或裸 PCM 格式，取字符串；默认 mp3。

可选项：pcmwavmp3opus

volumeinteger可选默认值: 50min 0max 100

输出音量，取 0 到 100 的整数；默认 50。

bit_rateinteger可选默认值: 32min 6max 510

Opus 编码码率，单位为 kbps，取整数；默认 32，仅当 format 为 opus 时生效。

instructionstring可选minLength 1

可选的合成指令，取字符串，用于对合成效果附加说明；不提供时按默认合成行为处理。

sample_rateinteger可选默认值: 22050

输出音频采样率，单位为 Hz，取整数；默认 22050。

可选项：80001600022050240004410048000

language_hintsarray可选minItems 1maxItems 1

可选的语种提示数组，元素为语种提示字符串；上游仅处理数组中的第一个元素。

Array [ string ]

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-audio-3.0-tts-plus",
  "input": {
    "rate": 1,
    "seed": 0,
    "text": "…",
    "pitch": 1,
    "voice": "longanlingxin",
    "format": "mp3",
    "volume": 50,
    "bit_rate": 32,
    "sample_rate": 22050
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-audio-3.0-tts-plus",
    input: {
      "rate": 1,
      "seed": 0,
      "text": "…",
      "pitch": 1,
      "voice": "longanlingxin",
      "format": "mp3",
      "volume": 50,
      "bit_rate": 32,
      "sample_rate": 22050
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-audio-3.0-tts-plus",
        "input": {
          "rate": 1,
          "seed": 0,
          "text": "…",
          "pitch": 1,
          "voice": "longanlingxin",
          "format": "mp3",
          "volume": 50,
          "bit_rate": 32,
          "sample_rate": 22050
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}