ガイド
APIの最小構成から始める場合と、感情指示を切り分ける場合の確認先を整理。音色・本文・指示を一つずつ確認し、結果音声を聞き比べる手順を紹介します。
CosyVoice 3 Flashで感情が意図どおりに変わらないときは、音色のInstruct対応、読み上げ本文の言語、制御指示の形式を順に確認します。すでに音声を生成できる場合は、音色と本文を固定し、指示を一つだけ加えて聞き比べてください。
APIXOから初めて合成する場合は、英語のCosyVoice 3 Flash APIガイドの最小リクエストから始めます。通常の読み上げができることを確認してから、この記事の音色・感情指示の切り分けに進みます。
日本語を読み上げたい場合も、国や記事の言語だけで音色を選ばず、公式音色一覧でその音色の対応言語とInstructを別々に確認してください。
公式音色一覧 は2026年10月8日更新です。音色ごとに、対応言語、Instruct、SSML、タイムスタンプの対応を掲載しています。
例えばlonganyangは所定形式のInstructに対応しますが、longanlang_v3は非対応と記載されています。音声合成への対応と感情制御への対応は別です。
他バージョンの似た名前ではなく、使用するモデルと正確な音色IDの項目を確認してください。
まず指示なしで2文を合成して比較の基準にします。音色と本文を固定し、対応する感情指示を一つだけ加えてください。問題を切り分ける方法であり、改善率を測定した結果ではありません。
longanyangの公式形式説明は中国語の句点を、例文はASCIIのピリオドを使っています。以下のリクエストは形式説明に合わせたもので、実行はしていません。使用ルートに詳細な条件があれば、それに従って短く試してから一括生成してください。検証済みの運用例ではありません。
読み上げ本文には音色が対応する言語を使います。制御指示には別の言語要件がある場合があります。longanyangのドキュメントは、英語本文を合成する際にも中国語の指示を求めています。
未送信の APIXO リクエスト本文の例は次のとおりです。
{
"request_type": "async",
"input": {
"mode": "speech",
"voice": "longanyang",
"prompt": "Welcome. We are glad you are here.",
"instruction": "你说话的情感是happy。",
"format": "mp3"
}
}中国語の制御文字列は原文を維持してください。公式の形式説明は中国語の句点を、例文はASCIIのピリオドを使っています。上記は未実行の例であり、成功を保証するものではありません。音色ごとの仕様を確認し、短いサンプルで試してください。
APIXO CosyVoice Docsの現行指示上限は100文字です。役割、場面、言語の指示を組み合わせる前に、感情一つで試します。
上のJSONはリクエスト本文の例です。送信先と認証ヘッダーは英語のAPIガイドに従って設定してください。JSONを用意しただけでは、合成や感情制御の成功は確認できません。
taskId を保存します。SSMLに対応していてもInstructには対応しない音色があります。組み合わせる前に両方を個別に確認してください。
短い2文を指示なしで合成し、同じ音色と本文に指示一つを加えて聞き比べます。音が変わらないという理由だけでは、国別の制限とは判断できません。
Alibaba Cloudのリージョン資料は、接続先、デプロイ、リソース設定を説明しています。北京とシンガポールには、それぞれ適切なサービス設定が必要です。
現行の公式表にはV3 Flashのシンガポールでの国際デプロイがあり、longanyangは北京とシンガポールの両方に掲載されています。確認した資料だけで、中国国外の利用者はAPIを使えないとは結論できません。同時に、すべてのアカウント、国、ネットワークから無制限に利用できる保証もありません。
機能別の差はあります。 音声クローンガイドは、シンガポールのV3 Flashではクローン音声による合成をサポートしないと記載しています。既存音色の利用可否とは別の制限です。 公式デプロイ表は提供元の資料であり、APIXO料金表ではありません。
APIXOの統合インターフェースと設定を使ってください。現行Docsはspeech・clone・designを案内し、合成には既存音色または作成したvoice_idを使います。APIXOが利用する上流サービスのリージョンは未確認のため、特定のAlibabaリージョンやその制限がそのまま適用されるとは判断しません。
音色、本文の言語、指示の長さ、カスタム音声の準備状況を確認します。失敗した場合はタスクID、エラーコード、パラメーターを残してください。本記事では国をまたぐAPI実測を行っていません。
次に確認する先は、問題に応じて選びます。送信方法や結果の取得はCosyVoice 3 Flash APIガイド（英語）、音色ごとの言語・Instruct対応は公式音色一覧で確認してください。
費用を確認するときはAPI従量料金を参照します。この記事のリクエスト例は未送信です。音色と本文を固定した短い比較から始め、取得できた音声を聞いて次の修正を決めてください。API料金とStudioの月間クレジットは別の仕組みです。
APIXOで開発
画像、動画、音声の各モデルを1つの場所で探索。