Alibaba

Qwen Audio 3.0 TTS

qwen-audio-3.0-tts-flash

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

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

试用 qwen-audio-3.0-tts-flash

输入

合成指令

作品灵感

查看全部作品

输出

audio

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

价格

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

单价	$0.030

定位简介

qwen-audio-3.0-tts-flash 是 Qwen Audio 3.0 TTS 系列中面向实时交互的文本转语音型号，通过 HiAPI.ai 统一接口调用。它把输入文本合成为自然语音，支持中、英、日、韩等 16 种语言提示，并可用自然语言指令调节情绪与表达风格。适合构建语音助手、对话式应用、客服播报与多语言配音的开发者，尤其是对首包延迟敏感、需要在响应速度与音质之间取平衡的实时场景。单次任务文本上限为 20000 个 Unicode 码点。

核心亮点

面向实时交互的低延迟档位——Flash 取向为实时响应，首包延迟在 300 毫秒级，适合同步对话与语音播报链路。
指令化控制情绪与表达风格——可通过可选 instruction 字段描述语气与表达方式，减少音频后期的二次处理。
多语言合成覆盖广——支持 16 种语言提示，同一模型即可服务多语种内容，无需按语种切换型号。
输出格式与采样率可选——支持 pcm、wav、mp3、opus 四种输出，采样率 8000 至 48000 Hz 可按播放端选择。

能力说明

多语言文本转语音：给定文本与音色即可合成语音，language_hints 可指定目标语种，一次接入覆盖多语种内容生产。

细粒度语音参数调节：语速与音调均可在 0.5 至 2 倍区间调整，音量 0 至 100，便于适配不同播放设备与内容节奏。

输出格式与采样率控制：可选择 mp3、wav、pcm 或 opus 输出，采样率覆盖 8000 至 48000 Hz，opus 下还能指定 6 至 510 kbps 码率。

指令与种子控制：instruction 字段用于描述合成风格，seed 可固定随机种子，便于复现同一段合成结果、稳定回归测试。

长文本单任务合成：单次任务接受最多 20000 个 Unicode 码点的文本，长段落无需在调用侧先行切分。

适用场景

实时语音助手开发者：对话回复文本——将对话系统的回复实时合成为语音，直接接入语音助手或对话式应用的播报环节。
客服与呼叫中心：播报话术文本——把标准话术与通知内容批量转为语音，用于电话外呼、IVR 提示与工单状态播报。
在线教育与有声内容：课程稿件——将课件与讲稿合成为可调节语速的音频，用于课程配音与有声读物制作。
多语言内容团队：多语种文案——同一份文案按语言提示合成不同语种版本，用于产品出海与多语言视频配音。

限制与选型建议

该型号为 Flash 档位，以响应速度为先，音色自然度与保真度不及同系列 Plus 变体，对成品音质要求高的场景建议改用 Plus。系统音色仅提供四个可选值，不支持从文字描述设计音色；声音克隆能力不在此型号的参数范围内。合成按输出字符计量，CJK 字符按两个字符计费，长文本批量生成时需预估用量。若需要自托管部署或开源权重，则不属于本型号的适用范围。

近期更新

查看更新日志 →

模型上新 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-flash

routestring可选

当前固定值：default

inputobject必填

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

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

语音速率倍数，默认 1，即正常语速；数值大于 1 表示加快，小于 1 表示放慢。

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

用于确定性合成的随机种子，默认 0；相同种子和输入可使合成结果可复现。

textstring必填minLength 1maxLength 20000

要合成为语音的文本。hiAPI 每个任务最多接受 20,000 个 Unicode 码点；Alibaba 计费时 CJK 表意文字按两个字符、其他字符按一个字符计算。

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

音调倍数，默认 1，即原始音高；数值增大会提高音调，减小会降低音调。

voicestring必填默认值: "longanhuan_v3.6"

指定 Flash 档位支持的系统音色，默认 longanhuan_v3.6。

可选项：longanhuan_v3.6longjielidou_v3.6loongeva_v3.6loongjohn

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

可选的语言提示数组；Qwen 仅处理数组中的第一个元素。

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-flash",
  "input": {
    "rate": 1,
    "seed": 0,
    "text": "…",
    "pitch": 1,
    "voice": "longanhuan_v3.6",
    "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-flash",
    input: {
      "rate": 1,
      "seed": 0,
      "text": "…",
      "pitch": 1,
      "voice": "longanhuan_v3.6",
      "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-flash",
        "input": {
          "rate": 1,
          "seed": 0,
          "text": "…",
          "pitch": 1,
          "voice": "longanhuan_v3.6",
          "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"
    }
  }
}