リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
text | はい | The words to be spoken, exactly as written. Billed per 1,000 characters, minimum 100. |
language | いいえ | 読み上げる言語。 auto · zh · en · de · fr · es · it · pt · ru · ja · ko · デフォルト: auto |
voice_id | いいえ | 使える声から選びます。 Serena · Vivian · Uncle_Fu · Dylan · Eric · Ryan · Aiden · Ono_Anna · Sohee · デフォルト: Serena |
instructions | いいえ | How to read the text: tone, emotion or pace. Not spoken and not billed. |
料金
料金はクレジットで表示され、サイトで使うクレジットと同じです(1クレジット = $0.01)。タスクの受付時に保留され、完了時に実際の料金で精算されます。失敗したタスクは返金されます。
| オプション | クレジット /1,000文字 | ≈ USD |
|---|---|---|
| 標準 | 10.2 | $0.10 |
タスクごとにクレジットは整数に切り上げられるため、最安の設定で 1 回実行すると 11クレジット/1,000文字($0.11)です。
実行前に正確な金額を知りたいときは、同じボディを POST /jobs/quote に送ってください。
API クイックスタート
Qwen3 TTS API を 3 ステップで呼び出す
- API キーを作成する. PopNow にログインし、API コンソールでキーを作成します。キーは sk-popnow- で始まり、サイトと同じクレジットを使います。
- リクエストを送る. POST /jobs/createTask に、model を alibaba/qwen-3-tts/text-to-speech、input をパラメーター表どおりにして送ります。レスポンスですぐにタスク ID が返ります。
- 結果を受け取る. タスク ID で GET /jobs/recordInfo をポーリングするか、callBackUrl を渡せば結果がそこへ送られます。タスクが成功したら出力リンクからダウンロードします。
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "Serena",
"language": "auto"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"プロンプトとリンクはご自身のものに置き換えてください。API タブにレスポンス、ポーリング、コールバックのリファレンスがあります。
Qwen3 TTS API についての質問
Qwen3 TTS API の料金はいくらですか?
Qwen3 TTSは11クレジット($0.11)/1,000文字です。クレジットはサイトと共通(1クレジット = $0.01)で、新規アカウントには30クレジットが付き、失敗したタスクは返金されます。
API でのQwen3 TTSのモデル名は?
POST /jobs/createTask の model フィールドに テキスト読み上げは alibaba/qwen-3-tts/text-to-speech を指定します。
読み方はどう制御しますか?
voice_id で 9 種類のボイスから 1 つを選び、instructions で読み方 (トーン、感情、テンポ) を 1〜2 文の平易な言葉で説明します。instructions は読み上げ方を決めるだけで、音声として読み上げられることはありません。
対応している言語は?
中国語、英語、ドイツ語、フランス語、スペイン語、イタリア語、ポルトガル語、ロシア語、日本語、韓国語です。うち 2 種類のボイスは北京語と四川語 (成都方言) を話します。language を指定しない限り、言語は台本から自動的に検出されます。
実在の人物の声を模写できますか?
できません。このエンドポイントで利用できるのは 9 種類のプリセットボイスのみで、クローンや参照音声のアップロードは提供していません。
Qwen3 TTS API の制限は?
テキストの長さ(文字):2,000;ボイス:9;言語:10。この範囲を超えるリクエストは、課金される前に拒否されます。
コードを書かずにQwen3 TTSを試せますか?
はい。Playground なら API キーなしで、PopNow のクレジットでQwen3 TTSを実行でき、実行ごとに対応するコードが表示されます。

