跳转到主要内容
POST
/
v1
/
audio
/
speech
curl --request POST \
  --url https://api.powertokens.ai/v1/audio/speech \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen3-tts-instruct-flash",
  "input": "请用略快的语速介绍这款产品。",
  "voice": "Cherry",
  "instructions": "语速较快，带有上扬语调。",
  "optimize_instructions": false,
  "language_type": "Chinese"
}
'
{
  "status_code": 123,
  "request_id": "<string>",
  "code": "<string>",
  "message": "<string>",
  "output": {
    "text": null,
    "finish_reason": "<string>",
    "choices": null,
    "audio": {
      "data": "<string>",
      "url": "<string>",
      "id": "<string>",
      "expires_at": 123
    }
  },
  "usage": {
    "input_tokens": 123,
    "output_tokens": 123,
    "total_tokens": 123,
    "characters": 123
  }
}

授权

​
Authorization
string
header
必填

在请求头中传入 Authorization: Bearer <token>。

请求头

​
X-DashScope-SSE
enum<string>

阿里官方 HTTP 流式开关。传 enable 时返回 text/event-stream。

可用选项:
enable

请求体

application/json
​
model
enum<string>
必填
可用选项:
qwen3-tts-instruct-flash
​
input
string
必填

待合成文本。

​
voice
enum<string>
必填

系统音色名称。当前仅支持本枚举中的音色。

可用选项:
Cherry,
Serena,
Ethan,
Chelsie,
Momo,
Vivian,
Moon,
Maia,
Kai,
Nofish,
Bella,
Eldric Sage,
Mia,
Mochi,
Bellona,
Vincent,
Bunny,
Neil,
Elias,
Arthur,
Nini,
Seren,
Pip,
Stella
​
instructions
string

风格控制指令。默认值：无默认值，不设置不生效,长度限制：长度不得超过 1600 Token,支持语言：仅支持中文和英文

​
optimize_instructions
boolean

是否优化 instructions。显式 false 也会保留并透传。

​
language_type
enum<string>

语言类型。

可用选项:
Auto,
Chinese,
English,
German,
Italian,
Portuguese,
Spanish,
Japanese,
Korean,
French,
Russian

响应

调用成功。非流式时返回阿里官方 JSON；流式时返回阿里 SSE 数据。

​
status_code
integer

HTTP 状态码。

​
request_id
string

阿里请求 ID。

​
code
string

错误码。成功时通常为空字符串。

​
message
string

错误信息。成功时通常为空字符串。

​
output
object
​
usage
object