すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:SSML と LaTeX

最終更新日:Nov 19, 2026

SSML で話す速度、ピッチ、音量などの音声特性を制御し、LaTeX で数式を中国語で読み上げます。サポート範囲、利用条件、API の例、タグと記号を説明します。

機能紹介

SSML は XML ベースの音声合成マークアップ言語です。音声、話す速度、ピッチ、音量などの音声特性を設定し、間を制御し、発音や読み方を指定できるほか、背景音楽や効果音を追加できます。CosyVoice の LaTeX 機能は、テキスト内の数式を中国語音声に変換します。

オーディオブック、カスタマーサービスでの案内、多言語の発音、オンライン教育などに利用できます。各機能で利用可能なモデル、音声、API は以下をご参照ください。モデルの選択については、音声合成をご参照ください。

利用条件

SSML

  • サポートするモデル: qwen-audio-3.1-tts-plus、qwen-audio-3.1-tts-flash、qwen-audio-3.0-tts-flash、qwen-audio-3.0-tts-plus、cosyvoice-v3.5-flash、cosyvoice-v3.5-plus、cosyvoice-v3-flash、cosyvoice-v3-plus、cosyvoice-v2

  • 音声: クローン音声、および Qwen-Audio-TTS 音声リスト または CosyVoice 音声リスト で SSML 対応と記載されているシステム音声を使用できます。

  • API:
    • Java SDK (バージョン 2.20.3 以降):非ストリーミングおよび単方向ストリーミングコール
    • Python SDK (バージョン 2.0.1 以降):非ストリーミングおよび単方向ストリーミングコール
    • WebSocket API: enable_ssml パラメーターを true に設定し、単一の continue-task イベントを送信します

LaTeX

  • サポートするモデル: cosyvoice-v3.5-plus、cosyvoice-v3.5-flash、cosyvoice-v3-plus、cosyvoice-v3-flash、cosyvoice-v2

  • 言語:中国語のみです。

  • 内容:サポートされるタグと記号を使用します。math として指定したブロックなど、Markdown の数式コードブロックはサポートされません。区切り文字内には数式のみを入れてください。他のテキストを入れると、正しく読み上げられない場合があります。

使用方法

SSML

SSML を使用する場合は、次のルールに従ってください。

  • すべてのテキストを <speak></speak> で囲みます。複数の <speak> 要素を並べることはできますが、ネストはできません。
  • タグ内の XML 特殊文字をエスケープします:" → &quot;、' → &apos;、& → &amp;、< → &lt;、> → &gt;。

クイックスタート

次の例では、SSML を使用して合成音声の話す速度を制御します。コードを実行する前に、次の前提条件を満たしてください:

  1. API キーの取得
  2. DashScope SDK (Python 2.0.1 以降、Java 2.20.3 以降) をインストールします。詳細については、「SDK のインストール」をご参照ください。

重要cosyvoice-v3.5-plus と cosyvoice-v3.5-flash にはプリセット音声がありません。このセクションの SSML サンプルでいずれかのモデルを使用する場合は、先に音声クローニングでクローン音声を作成してください。

Java SDK

import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesisParam;
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesizer;
import com.alibaba.dashscope.utils.Constants;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.nio.ByteBuffer;

/**
 * SSML 機能の説明:
 *     1. 非ストリーミングコールと単方向ストリーミングコールのみが SSML 機能をサポートします
 * SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。
 */
public class Main {
    private static String model = "cosyvoice-v3-flash";
    private static String voice = "longanyang";

    public static void main(String[] args) {
        // シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
        Constants.baseWebsocketApiUrl = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference";
        streamAudioDataToSpeaker();
        System.exit(0);
    }

    public static void streamAudioDataToSpeaker() {
        SpeechSynthesisParam param =
                SpeechSynthesisParam.builder()
                        // シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
                        // 環境変数を設定していない場合は、次の行を実際の Model Studio の API キーに置き換えてください: .apiKey("sk-xxx")
                        .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                        .model(model)
                        .voice(voice)
                        .build();

        SpeechSynthesizer synthesizer = new SpeechSynthesizer(param, null);
        ByteBuffer audio = null;
        try {
            // 非ストリーミングコール。音声が返されるまでブロックします
            // 特殊文字はエスケープする必要があります
            audio = synthesizer.call("<speak rate=\"2\">My speaking rate is faster than a normal person's.</speak>");
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            // タスク終了時に WebSocket 接続を閉じます
            synthesizer.getDuplexApi().close(1000, "bye");
        }
        if (audio != null) {
            // 音声データをローカルファイル "output.mp3" に保存します
            File file = new File("output.mp3");
            try (FileOutputStream fos = new FileOutputStream(file)) {
                fos.write(audio.array());
            } catch (IOException e) {
                throw new RuntimeException(e);
            }
        }

        // 初回テキスト送信時には WebSocket 接続を確立する必要があるため、初回パケットレイテンシーには接続確立時間が含まれます
        System.out.println(
                "[Metric] requestId: "
                        + synthesizer.getLastRequestId()
                        + ", first packet latency (ms): "
                        + synthesizer.getFirstPackageDelay());
    }
}
import com.alibaba.dashscope.audio.tts.SpeechSynthesisResult;
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesisAudioFormat;
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesisParam;
import com.alibaba.dashscope.audio.ttsv2.SpeechSynthesizer;
import com.alibaba.dashscope.common.ResultCallback;
import com.alibaba.dashscope.utils.Constants;

import java.io.FileOutputStream;
import java.io.IOException;
import java.util.concurrent.CountDownLatch;

/**
 * SSML 機能の説明:
 *     1. 非ストリーミングコールと単方向ストリーミングコールのみが SSML 機能をサポートします
 * SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。
 */
public class Main {
    private static String model = "cosyvoice-v3-flash";
    private static String voice = "longanyang";

    public static void main(String[] args) {
        // シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
        Constants.baseWebsocketApiUrl = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference";
        streamAudioDataToSpeaker();
        System.out.println("Audio has been saved to the output.mp3 file");
        System.exit(0);
    }

    public static void streamAudioDataToSpeaker() {
        CountDownLatch latch = new CountDownLatch(1);
        final FileOutputStream[] fileOutputStream = new FileOutputStream[1];

        try {
            fileOutputStream[0] = new FileOutputStream("output.mp3");
        } catch (IOException e) {
            System.err.println("Failed to create output file: " + e.getMessage());
            return;
        }

        // ResultCallback インターフェースを実装します
        ResultCallback<SpeechSynthesisResult> callback = new ResultCallback<SpeechSynthesisResult>() {
            @Override
            public void onEvent(SpeechSynthesisResult result) {
                if (result.getAudioFrame() != null) {
                    // 音声データをローカルファイルに書き込みます
                    try {
                        byte[] audioData = result.getAudioFrame().array();
                        fileOutputStream[0].write(audioData);
                        fileOutputStream[0].flush();
                    } catch (IOException e) {
                        System.err.println("Failed to write audio data: " + e.getMessage());
                    }
                }
            }

            @Override
            public void onComplete() {
                System.out.println("Received Complete, speech synthesis finished");
                closeFileOutputStream(fileOutputStream[0]);
                latch.countDown();
            }

            @Override
            public void onError(Exception e) {
                System.out.println("An error occurred: " + e.toString());
                closeFileOutputStream(fileOutputStream[0]);
                latch.countDown();
            }
        };

        SpeechSynthesisParam param =
                SpeechSynthesisParam.builder()
                        // シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
                        // 環境変数を設定していない場合は、次の行を実際の Model Studio の API キーに置き換えてください: .apiKey("sk-xxx")
                        .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                        .model(model)
                        .voice(voice)
                        .format(SpeechSynthesisAudioFormat.MP3_22050HZ_MONO_256KBPS)
                        .build();

        SpeechSynthesizer synthesizer = new SpeechSynthesizer(param, callback);

        try {
            // 単方向ストリーミングコール。すぐに null を返します (実際の結果はコールバックインターフェースを介して非同期に配信されます)。コールバックインターフェースの onEvent メソッドからリアルタイムでバイナリ音声を取得します
            // 特殊文字はエスケープする必要があります
            synthesizer.call("<speak rate=\"2\">My speaking rate is faster than a normal person's.</speak>");
            // 合成が完了するのを待ちます
            latch.await();
        } catch (Exception e) {
            throw new RuntimeException(e);
        } finally {
            // タスク終了後に WebSocket 接続を閉じます
            try {
                synthesizer.getDuplexApi().close(1000, "bye");
            } catch (Exception e) {
                System.err.println("Failed to close WebSocket connection: " + e.getMessage());
            }

            // ファイルストリームが確実に閉じられるようにします
            closeFileOutputStream(fileOutputStream[0]);
        }

        // 初回テキスト送信時には WebSocket 接続を確立する必要があるため、初回パケットレイテンシーには接続確立時間が含まれます
        System.out.println(
                "[Metric] requestId: "
                        + synthesizer.getLastRequestId()
                        + ", first packet latency (ms): "
                        + synthesizer.getFirstPackageDelay());
    }

    private static void closeFileOutputStream(FileOutputStream fileOutputStream) {
        try {
            if (fileOutputStream != null) {
                fileOutputStream.close();
            }
        } catch (IOException e) {
            System.err.println("Failed to close file stream: " + e.getMessage());
        }
    }
}

Python SDK

# coding=utf-8
# SSML 機能の説明:
#     1. SSML 機能は、非ストリーミング呼び出しと単方向ストリーミング呼び出しでのみサポートされます。
# SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。

import os

import dashscope

# シンガポールと北京リージョンの API キーは異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# 以下はシンガポールリージョンの設定です。呼び出し時に "{WorkspaceId}" を実際のワークスペース ID に置き換えてください。設定はリージョンによって異なります。
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

# モデル
model = "cosyvoice-v3-flash"
# 音声
voice = "longanyang"

# 非ストリーミング呼び出し。音声が返されるまでブロックします
# 特殊文字はエスケープする必要があります
audio = client.audio.tts.synthesize(
    "<speak rate=\"2\">My speaking rate is faster than a normal person's.</speak>",
    model=model,
    voice=voice,
    enable_ssml=True)

# 音声をローカルファイルに保存します
with open('output.mp3', 'wb') as f:
    f.write(audio)
# coding=utf-8
# SSML 機能の説明:
#     1. SSML 機能は、非ストリーミング呼び出しと単方向ストリーミング呼び出しでのみサポートされます。
# SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。

import os
from datetime import datetime

import dashscope

def get_timestamp():
    now = datetime.now()
    formatted_timestamp = now.strftime("[%Y-%m-%d %H:%M:%S.%f]")
    return formatted_timestamp

# シンガポールと北京リージョンの API キーは異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# 以下はシンガポールリージョンの設定です。呼び出し時に "{WorkspaceId}" を実際のワークスペース ID に置き換えてください。設定はリージョンによって異なります。
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

# モデル
model = "cosyvoice-v3-flash"
# 音声
voice = "longanyang"

# 単方向ストリーミング呼び出し。合成対象のテキストを送信し、バイナリ音声をチャンクごとにリアルタイムで取得します
# 特殊文字はエスケープする必要があります
with open("output.mp3", "wb") as f:
    for chunk in client.audio.tts.stream(
            "<speak rate=\"2\">My speaking rate is faster than a normal person's.</speak>",
            model=model,
            voice=voice,
            enable_ssml=True):
        print(get_timestamp() + " Binary audio length: " + str(len(chunk)))
        # 音声データをファイルに書き込みます
        f.write(chunk)
print("Speech synthesis completed, all results have been received: " + get_timestamp())

WebSocket API

Java

Java 開発では、Java DashScope SDK を使用します。詳細については、「Java SDK」をご参照ください。

この Java WebSocket の例では、次の依存関係が必要です:

  • Java-WebSocket
  • jackson-databind

これらの依存関係は、Maven または Gradle で管理します:

<dependencies>
    <!-- WebSocketクライアント -->
    <dependency>
        <groupId>org.java-websocket</groupId>
        <artifactId>Java-WebSocket</artifactId>
        <version>1.5.3</version>
    </dependency>

    <!-- JSON処理 -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.13.0</version>
    </dependency>
</dependencies>
dependencies {
  // WebSocketクライアント
  implementation 'org.java-websocket:Java-WebSocket:1.5.3'
  // JSON処理
  implementation 'com.fasterxml.jackson.core:jackson-databind:2.13.0'
}

Java コード:

import com.fasterxml.jackson.databind.ObjectMapper;

import org.java_websocket.client.WebSocketClient;
import org.java_websocket.handshake.ServerHandshake;

import java.io.FileOutputStream;
import java.io.IOException;
import java.net.URI;
import java.nio.ByteBuffer;
import java.util.*;

/**
 * SSML 機能の説明:
 *     1. run-task コマンドを送信する際に、enable_ssml パラメーターを true に設定して SSML サポートを有効にします
 *     2. continue-task コマンドで SSML を含むテキストを送信します。continue-task コマンドは 1 回のみ送信可能です
 * SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。
 */
public class TTSWebSocketClient extends WebSocketClient {
    private final String taskId = UUID.randomUUID().toString();
    private final String outputFile = "output_" + System.currentTimeMillis() + ".mp3";
    private boolean taskFinished = false;

    public TTSWebSocketClient(URI serverUri, Map<String, String> headers) {
        super(serverUri, headers);
    }

    @Override
    public void onOpen(ServerHandshake serverHandshake) {
        System.out.println("Connection established");

        // run-task コマンドを送信します
        // enable_ssml が true に設定されている場合、continue-task コマンドは 1 回しか送信できません。そうでない場合、エラー "Text request limit violated, expected 1." が返されます
        String runTaskCommand = "{ \"header\": { \"action\": \"run-task\", \"task_id\": \"" + taskId + "\", \"streaming\": \"duplex\" }, \"payload\": { \"task_group\": \"audio\", \"task\": \"tts\", \"function\": \"SpeechSynthesizer\", \"model\": \"cosyvoice-v3-flash\", \"parameters\": { \"text_type\": \"PlainText\", \"voice\": \"longanyang\", \"format\": \"mp3\", \"sample_rate\": 22050, \"volume\": 50, \"rate\": 1, \"pitch\": 1, \"enable_ssml\": true }, \"input\": {} }}";
        send(runTaskCommand);
    }

    @Override
    public void onMessage(String message) {
        System.out.println("Received message from server: " + message);
        try {
            // JSON メッセージを解析します
            Map<String, Object> messageMap = new ObjectMapper().readValue(message, Map.class);

            if (messageMap.containsKey("header")) {
                Map<String, Object> header = (Map<String, Object>) messageMap.get("header");

                if (header.containsKey("event")) {
                    String event = (String) header.get("event");

                    if ("task-started".equals(event)) {
                        System.out.println("Received task-started event from server");

                        // continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
                        // 特殊文字はエスケープする必要があります
                        sendContinueTask("<speak rate=\\\"2\\\">私の話速は通常の人より速いです。</speak>");

                        // finish-task コマンドを送信します
                        sendFinishTask();
                    } else if ("task-finished".equals(event)) {
                        System.out.println("Received task-finished event from server");
                        taskFinished = true;
                        closeConnection();
                    } else if ("task-failed".equals(event)) {
                        System.out.println("Task failed: " + message);
                        closeConnection();
                    }
                }
            }
        } catch (Exception e) {
            System.err.println("An error occurred: " + e.getMessage());
        }
    }

    @Override
    public void onMessage(ByteBuffer message) {
        System.out.println("Received binary audio data, size: " + message.remaining());

        try (FileOutputStream fos = new FileOutputStream(outputFile, true)) {
            byte[] buffer = new byte[message.remaining()];
            message.get(buffer);
            fos.write(buffer);
            System.out.println("Audio data written to local file " + outputFile);
        } catch (IOException e) {
            System.err.println("Failed to write audio data to local file: " + e.getMessage());
        }
    }

    @Override
    public void onClose(int code, String reason, boolean remote) {
        System.out.println("Connection closed: " + reason + " (" + code + ")");
    }

    @Override
    public void onError(Exception ex) {
        System.err.println("Error: " + ex.getMessage());
        ex.printStackTrace();
    }

    private void sendContinueTask(String text) {
        String command = "{ \"header\": { \"action\": \"continue-task\", \"task_id\": \"" + taskId + "\", \"streaming\": \"duplex\" }, \"payload\": { \"input\": { \"text\": \"" + text + "\" } }}";
        send(command);
    }

    private void sendFinishTask() {
        String command = "{ \"header\": { \"action\": \"finish-task\", \"task_id\": \"" + taskId + "\", \"streaming\": \"duplex\" }, \"payload\": { \"input\": {} }}";
        send(command);
    }

    private void closeConnection() {
        if (!isClosed()) {
            close();
        }
    }

    public static void main(String[] args) {
        try {
            // シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
            // 環境変数を設定していない場合は、次の行を実際の Model Studio API キーに置き換えてください: String apiKey = "sk-xxx"
            String apiKey = System.getenv("DASHSCOPE_API_KEY");
            if (apiKey == null || apiKey.isEmpty()) {
                System.err.println("Please set the DASHSCOPE_API_KEY environment variable");
                return;
            }

            Map<String, String> headers = new HashMap<>();
            headers.put("Authorization", "bearer " + apiKey);
            // シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
            TTSWebSocketClient client = new TTSWebSocketClient(new URI("wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/"), headers);

            client.connect();

            while (!client.isClosed() && !client.taskFinished) {
                Thread.sleep(1000);
            }
        } catch (Exception e) {
            System.err.println("Failed to connect to WebSocket service: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Python

Python 開発には、Python DashScope SDK を使用します。詳細については、「Python SDK」をご参照ください。

以下は Python WebSocket の例です。実行する前に、必要な依存関係をインストールしてください:

pip uninstall websocket-client
pip uninstall websocket
pip install websocket-client

重要Python のサンプルファイルに websocket.py という名前を付けると、名前が競合し、次のエラー (AttributeError: module 'websocket' has no attribute 'WebSocketApp'. Did you mean: 'WebSocket'?) が発生します。

# SSML 機能の説明:
#     1. run-task コマンドを送信する際に、enable_ssml パラメーターを true に設定して SSML サポートを有効にします
#     2. SSML を含むテキストを continue-task コマンドで送信します。continue-task コマンドは1回しか使用できません
# SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。

import websocket
import json
import uuid
import os
import time

class TTSClient:
    def __init__(self, api_key, uri):
        """
    TTSClient インスタンスを初期化します

    パラメーター:
        api_key (str): 認証用の API キー
        uri (str): WebSocket サービスアドレス
    """
        self.api_key = api_key  # API キーに置き換えてください
        self.uri = uri  # WebSocket アドレスに置き換えてください
        self.task_id = str(uuid.uuid4())  # 一意のタスク ID を生成します
        self.output_file = f"output_{int(time.time())}.mp3"  # 出力音声ファイルパス
        self.ws = None  # WebSocketApp インスタンス
        self.task_started = False  # task-started を受信したかどうか
        self.task_finished = False  # task-finished / task-failed を受信したかどうか

    def on_open(self, ws):
        """
    WebSocket 接続が確立されたときのコールバック
    run-task コマンドを送信して音声合成タスクを開始します
    """
        print("WebSocket connected")

        # run-task コマンドを構築します
        run_task_cmd = {
            "header": {
                "action": "run-task",
                "task_id": self.task_id,
                "streaming": "duplex"
            },
            "payload": {
                "task_group": "audio",
                "task": "tts",
                "function": "SpeechSynthesizer",
                "model": "cosyvoice-v3-flash",
                "parameters": {
                    "text_type": "PlainText",
                    "voice": "longanyang",
                    "format": "mp3",
                    "sample_rate": 22050,
                    "volume": 50,
                    "rate": 1,
                    "pitch": 1,
                    # enable_ssml が True に設定されている場合、continue-task コマンドは1回しか送信できません。そうでない場合、エラー "Text request limit violated, expected 1." が返されます
                    "enable_ssml": True
                },
                "input": {}
            }
        }

        # run-task コマンドを送信します
        ws.send(json.dumps(run_task_cmd))
        print("run-task command sent")

    def on_message(self, ws, message):
        """
    メッセージを受信したときのコールバック
    テキストメッセージとバイナリメッセージを別々に処理します
    """
        if isinstance(message, str):
            # JSON テキストメッセージを処理します
            try:
                msg_json = json.loads(message)
                print(f"Received JSON message: {msg_json}")

                if "header" in msg_json:
                    header = msg_json["header"]

                    if "event" in header:
                        event = header["event"]

                        if event == "task-started":
                            print("Task started")
                            self.task_started = True

                            # continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
                            # 特殊文字はエスケープする必要があります
                            self.send_continue_task("<speak rate=\"2\">私の話速は通常の人より速いです。</speak>")

                            # continue-task が送信された後、finish-task を送信します
                            self.send_finish_task()

                        elif event == "task-finished":
                            print("Task completed")
                            self.task_finished = True
                            self.close(ws)

                        elif event == "task-failed":
                            error_msg = msg_json.get("error_message", "Unknown error")
                            print(f"Task failed: {error_msg}")
                            self.task_finished = True
                            self.close(ws)

            except json.JSONDecodeError as e:
                print(f"JSON parsing failed: {e}")
        else:
            # バイナリメッセージ (音声データ) を処理します
            print(f"Received binary message, size: {len(message)} bytes")
            with open(self.output_file, "ab") as f:
                f.write(message)
            print(f"音声データをローカルファイル {self.output_file} に書き込みました")

    def on_error(self, ws, error):
        """エラーが発生したときのコールバック"""
        print(f"WebSocket error: {error}")

    def on_close(self, ws, close_status_code, close_msg):
        """接続が閉じたときのコールバック"""
        print(f"WebSocket closed: {close_msg} ({close_status_code})")

    def send_continue_task(self, text):
        """合成するテキストコンテンツを含む continue-task コマンドを送信します"""
        cmd = {
            "header": {
                "action": "continue-task",
                "task_id": self.task_id,
                "streaming": "duplex"
            },
            "payload": {
                "input": {
                    "text": text
                }
            }
        }

        self.ws.send(json.dumps(cmd))
        print(f"continue-task command sent, text content: {text}")

    def send_finish_task(self):
        """音声合成タスクを終了するために finish-task コマンドを送信します"""
        cmd = {
            "header": {
                "action": "finish-task",
                "task_id": self.task_id,
                "streaming": "duplex"
            },
            "payload": {
                "input": {}
            }
        }

        self.ws.send(json.dumps(cmd))
        print("finish-task command sent")

    def close(self, ws):
        """接続を能動的に閉じます"""
        if ws and ws.sock and ws.sock.connected:
            ws.close()
            print("接続を能動的に閉じました")

    def run(self):
        """WebSocket クライアントを開始します"""
        # リクエストヘッダー (認証) を設定します
        header = {
            "Authorization": f"bearer {self.api_key}",
            "X-DashScope-DataInspection": "enable"
        }

        # WebSocketApp インスタンスを作成します
        self.ws = websocket.WebSocketApp(
            self.uri,
            header=header,
            on_open=self.on_open,
            on_message=self.on_message,
            on_error=self.on_error,
            on_close=self.on_close
        )

        print("WebSocket メッセージを待機中...")
        self.ws.run_forever()  # 永続的な接続リスナーを開始します

# 使用例
if __name__ == "__main__":
    # シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
    # 環境変数を設定していない場合は、次の行を実際の Model Studio API キーに置き換えてください: API_KEY = "sk-xxx"
    API_KEY = os.environ.get("DASHSCOPE_API_KEY")
    # シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    SERVER_URI = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/"

    client = TTSClient(API_KEY, SERVER_URI)
    client.run()

Go

// SSML 機能の説明:
//     1. run-task コマンドを送信する際に、enable_ssml パラメータを true に設定して SSML サポートを有効にします。
//     2. continue-task コマンドを介して SSML を含むテキストを送信し、continue-task コマンドは 1 回しか送信できません。
// SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
    "strings"
    "time"

    "github.com/google/uuid"
    "github.com/gorilla/websocket"
)

const (
    // シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    wsURL      = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/"
    outputFile = "output.mp3"
)

func main() {
    // シンガポールと北京リージョンの API キーは異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
    // 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: apiKey := "sk-xxx"
    apiKey := os.Getenv("DASHSCOPE_API_KEY")

    // 出力ファイルをクリアします
    os.Remove(outputFile)
    os.Create(outputFile)

    // WebSocket に接続します
    header := make(http.Header)
    header.Add("X-DashScope-DataInspection", "enable")
    header.Add("Authorization", fmt.Sprintf("bearer %s", apiKey))

    conn, resp, err := websocket.DefaultDialer.Dial(wsURL, header)
    if err != nil {
        if resp != nil {
            fmt.Printf("Connection failed, HTTP status code: %d\n", resp.StatusCode)
        }
        fmt.Println("Connection failed:", err)
        return
    }
    defer conn.Close()

    // タスク ID を生成します
    taskID := uuid.New().String()
    fmt.Printf("Generated task ID: %s\n", taskID)

    // run-task コマンドを送信します
    runTaskCmd := map[string]interface{}{
        "header": map[string]interface{}{
            "action":    "run-task",
            "task_id":   taskID,
            "streaming": "duplex",
        },
        "payload": map[string]interface{}{
            "task_group": "audio",
            "task":       "tts",
            "function":   "SpeechSynthesizer",
            "model":      "cosyvoice-v3-flash",
            "parameters": map[string]interface{}{
                "text_type":   "PlainText",
                "voice":       "longanyang",
                "format":      "mp3",
                "sample_rate": 22050,
                "volume":      50,
                "rate":        1,
                "pitch":       1,
                // enable_ssml を true に設定した場合、continue-task コマンドは 1 回しか送信できません。それ以外の場合、エラー "Text request limit violated, expected 1." が返されます
                "enable_ssml": true,
            },
            "input": map[string]interface{}{},
        },
    }

    runTaskJSON, _ := json.Marshal(runTaskCmd)
    fmt.Printf("Sending run-task command: %s\n", string(runTaskJSON))

    err = conn.WriteMessage(websocket.TextMessage, runTaskJSON)
    if err != nil {
        fmt.Println("Failed to send run-task:", err)
        return
    }

    textSent := false

    // メッセージを処理します
    for {
        messageType, message, err := conn.ReadMessage()
        if err != nil {
            fmt.Println("Failed to read message:", err)
            break
        }

        // バイナリメッセージを処理します
        if messageType == websocket.BinaryMessage {
            fmt.Printf("Received binary message, length: %d\n", len(message))
            file, _ := os.OpenFile(outputFile, os.O_APPEND|os.O_WRONLY|os.O_CREATE, 0644)
            file.Write(message)
            file.Close()
            continue
        }

        // テキストメッセージを処理します
        messageStr := string(message)
        fmt.Printf("Received text message: %s\n", strings.ReplaceAll(messageStr, "\n", ""))

        // イベントタイプを取得するための簡単な JSON 解析
        var msgMap map[string]interface{}
        if json.Unmarshal(message, &msgMap) == nil {
            if header, ok := msgMap["header"].(map[string]interface{}); ok {
                if event, ok := header["event"].(string); ok {
                    fmt.Printf("Event type: %s\n", event)

                    switch event {
                    case "task-started":
                        fmt.Println("=== Received task-started event ===")

                        if !textSent {
                            // continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
                            continueTaskCmd := map[string]interface{}{
                                "header": map[string]interface{}{
                                    "action":    "continue-task",
                                    "task_id":   taskID,
                                    "streaming": "duplex",
                                },
                                "payload": map[string]interface{}{
                                    "input": map[string]interface{}{
                                        // 特殊文字はエスケープする必要があります
                                        "text": "<speak rate=\"2\">My speaking rate is faster than a normal person's.</speak>",
                                    },
                                },
                            }

                            continueTaskJSON, _ := json.Marshal(continueTaskCmd)
                            fmt.Printf("Sending continue-task command: %s\n", string(continueTaskJSON))

                            err = conn.WriteMessage(websocket.TextMessage, continueTaskJSON)
                            if err != nil {
                                fmt.Println("Failed to send continue-task:", err)
                                return
                            }

                            textSent = true

                            // finish-task を送信する前に待機します
                            time.Sleep(500 * time.Millisecond)

                            // finish-task コマンドを送信します
                            finishTaskCmd := map[string]interface{}{
                                "header": map[string]interface{}{
                                    "action":    "finish-task",
                                    "task_id":   taskID,
                                    "streaming": "duplex",
                                },
                                "payload": map[string]interface{}{
                                    "input": map[string]interface{}{},
                                },
                            }

                            finishTaskJSON, _ := json.Marshal(finishTaskCmd)
                            fmt.Printf("Sending finish-task command: %s\n", string(finishTaskJSON))

                            err = conn.WriteMessage(websocket.TextMessage, finishTaskJSON)
                            if err != nil {
                                fmt.Println("Failed to send finish-task:", err)
                                return
                            }
                        }

                    case "task-finished":
                        fmt.Println("=== Task completed ===")
                        return

                    case "task-failed":
                        fmt.Println("=== Task failed ===")
                        if header["error_message"] != nil {
                            fmt.Printf("Error message: %s\n", header["error_message"])
                        }
                        return

                    case "result-generated":
                        fmt.Println("Received result-generated event")
                    }
                }
            }
        }
    }
}

C#

using System.Net.WebSockets;
using System.Text;
using System.Text.Json;

// SSML 機能の説明:
//     1. run-task コマンドを送信する際に、enable_ssml パラメーターを true に設定して SSML サポートを有効にします
//     2. SSML を含むテキストを continue-task コマンドで送信します。このコマンドは 1 回のみ送信できます
// SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。
class Program {
    // シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得: https://www.alibabacloud.com/help/model-studio/get-api-key
    // 環境変数を設定していない場合は、次の行を実際の Model Studio API キーに置き換えてください: private static readonly string ApiKey = "sk-xxx"
    private static readonly string ApiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY") ?? throw new InvalidOperationException("DASHSCOPE_API_KEY environment variable is not set.");

    // シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
    private const string WebSocketUrl = "wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/";
    // 出力ファイルパス
    private const string OutputFilePath = "output.mp3";

    // WebSocket クライアント
    private static ClientWebSocket _webSocket = new ClientWebSocket();
    // キャンセル トークン ソース
    private static CancellationTokenSource _cancellationTokenSource = new CancellationTokenSource();
    // タスク ID
    private static string? _taskId;
    // タスクが開始されたかどうか
    private static TaskCompletionSource<bool> _taskStartedTcs = new TaskCompletionSource<bool>();

    static async Task Main(string[] args) {
        try {
            // 出力ファイルをクリアします
            ClearOutputFile(OutputFilePath);

            // WebSocket サービスに接続します
            await ConnectToWebSocketAsync(WebSocketUrl);

            // メッセージ受信タスクを開始します
            Task receiveTask = ReceiveMessagesAsync();

            // run-task コマンドを送信します
            _taskId = GenerateTaskId();
            await SendRunTaskCommandAsync(_taskId);

            // task-started イベントを待ちます
            await _taskStartedTcs.Task;

            // continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
            // 特殊文字はエスケープする必要があります
            await SendContinueTaskCommandAsync("<speak rate=\"2\">私の話す速度は普通の人より速いです。</speak>");

            // finish-task コマンドを送信します
            await SendFinishTaskCommandAsync(_taskId);

            // 受信タスクが完了するのを待ちます
            await receiveTask;

            Console.WriteLine("Task completed, connection closed.");
        } catch (OperationCanceledException) {
            Console.WriteLine("Task was cancelled.");
        } catch (Exception ex) {
            Console.WriteLine($"An error occurred: {ex.Message}");
        } finally {
            _cancellationTokenSource.Cancel();
            _webSocket.Dispose();
        }
    }

    private static void ClearOutputFile(string filePath) {
        if (File.Exists(filePath)) {
            File.WriteAllText(filePath, string.Empty);
            Console.WriteLine("Output file cleared.");
        } else {
            Console.WriteLine("Output file does not exist, no need to clear.");
        }
    }

    private static async Task ConnectToWebSocketAsync(string url) {
        var uri = new Uri(url);
        if (_webSocket.State == WebSocketState.Connecting || _webSocket.State == WebSocketState.Open) {
            return;
        }

        // WebSocket 接続ヘッダーを設定します
        _webSocket.Options.SetRequestHeader("Authorization", $"bearer {ApiKey}");
        _webSocket.Options.SetRequestHeader("X-DashScope-DataInspection", "enable");

        try {
            await _webSocket.ConnectAsync(uri, _cancellationTokenSource.Token);
            Console.WriteLine("Successfully connected to the WebSocket service.");
        } catch (OperationCanceledException) {
            Console.WriteLine("WebSocket connection was cancelled.");
        } catch (Exception ex) {
            Console.WriteLine($"WebSocket connection failed: {ex.Message}");
            throw;
        }
    }

    private static async Task SendRunTaskCommandAsync(string taskId) {
        var command = CreateCommand("run-task", taskId, "duplex", new {
            task_group = "audio",
            task = "tts",
            function = "SpeechSynthesizer",
            model = "cosyvoice-v3-flash",
            parameters = new
            {
                text_type = "PlainText",
                voice = "longanyang",
                format = "mp3",
                sample_rate = 22050,
                volume = 50,
                rate = 1,
                pitch = 1,
                // enable_ssml が true に設定されている場合、continue-task コマンドは 1 回しか送信できません。そうでない場合、エラー "Text request limit violated, expected 1." が返されます
                enable_ssml = true
            },
            input = new { }
        });

        await SendJsonMessageAsync(command);
        Console.WriteLine("run-task command sent.");
    }

    private static async Task SendContinueTaskCommandAsync(string text) {
        if (_taskId == null) {
            throw new InvalidOperationException("Task ID is not initialized.");
        }

        var command = CreateCommand("continue-task", _taskId, "duplex", new {
            input = new {
                text
            }
        });

        await SendJsonMessageAsync(command);
        Console.WriteLine("continue-task command sent.");
    }

    private static async Task SendFinishTaskCommandAsync(string taskId) {
        var command = CreateCommand("finish-task", taskId, "duplex", new {
            input = new { }
        });

        await SendJsonMessageAsync(command);
        Console.WriteLine("finish-task command sent.");
    }

    private static async Task SendJsonMessageAsync(string message) {
        var buffer = Encoding.UTF8.GetBytes(message);
        try {
            await _webSocket.SendAsync(new ArraySegment<byte>(buffer), WebSocketMessageType.Text, true, _cancellationTokenSource.Token);
        } catch (OperationCanceledException) {
            Console.WriteLine("Message sending was cancelled.");
        }
    }

    private static async Task ReceiveMessagesAsync() {
        while (_webSocket.State == WebSocketState.Open) {
            var response = await ReceiveMessageAsync();
            if (response != null) {
                var eventStr = response.RootElement.GetProperty("header").GetProperty("event").GetString();
                switch (eventStr) {
                    case "task-started":
                        Console.WriteLine("Task started.");
                        _taskStartedTcs.TrySetResult(true);
                        break;
                    case "task-finished":
                        Console.WriteLine("Task finished.");
                        _cancellationTokenSource.Cancel();
                        break;
                    case "task-failed":
                        Console.WriteLine("Task failed: " + response.RootElement.GetProperty("header").GetProperty("error_message").GetString());
                        _cancellationTokenSource.Cancel();
                        break;
                    default:
                        // ここで result-generated を処理できます
                        break;
                }
            }
        }
    }

    private static async Task<JsonDocument?> ReceiveMessageAsync() {
        var buffer = new byte[1024 * 4];
        var segment = new ArraySegment<byte>(buffer);

        try {
            WebSocketReceiveResult result = await _webSocket.ReceiveAsync(segment, _cancellationTokenSource.Token);

            if (result.MessageType == WebSocketMessageType.Close) {
                await _webSocket.CloseAsync(WebSocketCloseStatus.NormalClosure, "Closing", _cancellationTokenSource.Token);
                return null;
            }

            if (result.MessageType == WebSocketMessageType.Binary) {
                // バイナリデータを処理します
                Console.WriteLine("Received binary data...");

                // バイナリデータをファイルに保存します
                using (var fileStream = new FileStream(OutputFilePath, FileMode.Append)) {
                    fileStream.Write(buffer, 0, result.Count);
                }

                return null;
            }

            string message = Encoding.UTF8.GetString(buffer, 0, result.Count);
            return JsonDocument.Parse(message);
        } catch (OperationCanceledException) {
            Console.WriteLine("Message receiving was cancelled.");
            return null;
        }
    }

    private static string GenerateTaskId() {
        return Guid.NewGuid().ToString("N").Substring(0, 32);
    }

    private static string CreateCommand(string action, string taskId, string streaming, object payload) {
        var command = new {
            header = new {
                action,
                task_id = taskId,
                streaming
            },
            payload
        };

        return JsonSerializer.Serialize(command);
    }
}

PHP

サンプルコードのディレクトリ構造は次のとおりです。

my-php-project/

├── composer.json

├── vendor/

└── index.php

composer.json ファイルには、次の依存関係が含まれています。必要に応じてバージョン番号を調整してください。

{
    "require": {
        "react/event-loop": "^1.3",
        "react/socket": "^1.11",
        "react/stream": "^1.2",
        "react/http": "^1.1",
        "ratchet/pawl": "^0.4"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

index.php ファイルには、次のコードが含まれています。

<!-- SSML 機能の説明: -->
<!--     1. run-task コマンドを送信する際に、enable_ssml パラメーターを true に設定して SSML サポートを有効にします -->
<!--     2. SSML を含むテキストを continue-task コマンドで送信します。continue-task コマンドは1回しか送信できません -->
<!--     3. cosyvoice-v3-flash、cosyvoice-v3-plus、cosyvoice-v2 モデルのクローン音声、および音声リストで SSML 対応とマークされたシステム音声のみが SSML 機能をサポートします (例:cosyvoice-v3-flash モデルの longanyang 音声) -->

<?php

require __DIR__ . '/vendor/autoload.php';

use Ratchet\Client\Connector;
use React\EventLoop\Loop;
use React\Socket\Connector as SocketConnector;

// シンガポールリージョンと北京リージョンでは API キーが異なります。API キーの取得方法: https://www.alibabacloud.com/help/en/model-studio/get-api-key
// 環境変数を設定していない場合は、次の行を実際の Model Studio API キーに置き換えてください: $api_key = "sk-xxx"
$api_key = getenv("DASHSCOPE_API_KEY");
// シンガポールリージョンの URL。{WorkspaceId} を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
$websocket_url = 'wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/'; // WebSocket サーバーアドレス
$output_file = 'output.mp3'; // 出力ファイルパス

$loop = Loop::get();

if (file_exists($output_file)) {
    // ファイルの内容をクリアします
    file_put_contents($output_file, '');
}

// カスタムコネクタを作成します
$socketConnector = new SocketConnector($loop, [
    'tcp' => [
        'bindto' => '0.0.0.0:0',
    ],
    'tls' => [
        'verify_peer' => false,
        'verify_peer_name' => false,
    ],
]);

$connector = new Connector($loop, $socketConnector);

$headers = [
    'Authorization' => 'bearer ' . $api_key,
    'X-DashScope-DataInspection' => 'enable'
];

$connector($websocket_url, [], $headers)->then(function ($conn) use ($loop, $output_file) {
    echo "Connected to WebSocket server\n";

    // タスク ID を生成します
    $taskId = generateTaskId();

    // run-task コマンドを送信します
    sendRunTaskMessage($conn, $taskId);

    // continue-task コマンドを送信する関数を定義します
    $sendContinueTask = function() use ($conn, $loop, $taskId) {
        // continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
        $continueTaskMessage = json_encode([
            "header" => [
                "action" => "continue-task",
                "task_id" => $taskId,
                "streaming" => "duplex"
            ],
            "payload" => [
                "input" => [
                    // 特殊文字はエスケープする必要があります
                    "text" => "<speak rate=\"2\">私の話速は、一般的な人よりも速いです。</speak>"
                ]
            ]
        ]);
        $conn->send($continueTaskMessage);

        // finish-task コマンドを送信します
        sendFinishTaskMessage($conn, $taskId);
    };

    // task-started イベントを受信したかどうかを示すフラグ
    $taskStarted = false;

    // メッセージをリッスンします
    $conn->on('message', function($msg) use ($conn, $sendContinueTask, $loop, &$taskStarted, $taskId, $output_file) {
        if ($msg->isBinary()) {
            // バイナリデータをローカルファイルに書き込みます
            file_put_contents($output_file, $msg->getPayload(), FILE_APPEND);
        } else {
            // バイナリ以外のメッセージを処理します
            $response = json_decode($msg, true);

            if (isset($response['header']['event'])) {
                handleEvent($conn, $response, $sendContinueTask, $loop, $taskId, $taskStarted);
            } else {
                echo "Unknown message format\n";
            }
        }
    });

    // 接続クローズをリッスンします
    $conn->on('close', function($code = null, $reason = null) {
        echo "Connection closed\n";
        if ($code !== null) {
            echo "Close code: " . $code . "\n";
        }
        if ($reason !== null) {
            echo "Close reason: " . $reason . "\n";
        }
    });
}, function ($e) {
    echo "Unable to connect: {$e->getMessage()}\n";
});

$loop->run();

/**
 * タスク ID を生成します
 * @return string
 */
function generateTaskId(): string {
    return bin2hex(random_bytes(16));
}

/**
 * run-task コマンドを送信します
 * @param $conn
 * @param $taskId
 */
function sendRunTaskMessage($conn, $taskId) {
    $runTaskMessage = json_encode([
        "header" => [
            "action" => "run-task",
            "task_id" => $taskId,
            "streaming" => "duplex"
        ],
        "payload" => [
            "task_group" => "audio",
            "task" => "tts",
            "function" => "SpeechSynthesizer",
            "model" => "cosyvoice-v3-flash",
            "parameters" => [
                "text_type" => "PlainText",
                "voice" => "longanyang",
                "format" => "mp3",
                "sample_rate" => 22050,
                "volume" => 50,
                "rate" => 1,
                "pitch" => 1,
                // enable_ssml が true に設定されている場合、continue-task コマンドは 1 回しか送信できません。そうでない場合、エラー "Text request limit violated, expected 1." が返されます
                "enable_ssml" => true
            ],
            "input" => (object) []
        ]
    ]);
    echo "Preparing to send run-task command: " . $runTaskMessage . "\n";
    $conn->send($runTaskMessage);
    echo "run-task command sent\n";
}

/**
 * 音声ファイルを読み込みます
 * @param string $filePath
 * @return bool|string
 */
function readAudioFile(string $filePath) {
    $voiceData = file_get_contents($filePath);
    if ($voiceData === false) {
        echo "Unable to read audio file\n";
    }
    return $voiceData;
}

/**
 * 音声データを分割します
 * @param string $data
 * @param int $chunkSize
 * @return array
 */
function splitAudioData(string $data, int $chunkSize): array {
    return str_split($data, $chunkSize);
}

/**
 * finish-task コマンドを送信します
 * @param $conn
 * @param $taskId
 */
function sendFinishTaskMessage($conn, $taskId) {
    $finishTaskMessage = json_encode([
        "header" => [
            "action" => "finish-task",
            "task_id" => $taskId,
            "streaming" => "duplex"
        ],
        "payload" => [
            "input" => (object) []
        ]
    ]);
    echo "Preparing to send finish-task command: " . $finishTaskMessage . "\n";
    $conn->send($finishTaskMessage);
    echo "finish-task command sent\n";
}

/**
 * イベントを処理します
 * @param $conn
 * @param $response
 * @param $sendContinueTask
 * @param $loop
 * @param $taskId
 * @param $taskStarted
 */
function handleEvent($conn, $response, $sendContinueTask, $loop, $taskId, &$taskStarted) {
    switch ($response['header']['event']) {
        case 'task-started':
            echo "タスクが開始されました、continue-task コマンドを送信しています...\n";
            $taskStarted = true;
            // continue-task コマンドを送信します
            $sendContinueTask();
            break;
        case 'result-generated':
            // result-generated イベントを無視します
            break;
        case 'task-finished':
            echo "タスクが完了しました\n";
            $conn->close();
            break;
        case 'task-failed':
            echo "タスクが失敗しました\n";
            echo "エラーコード: " . $response['header']['error_code'] . "\n";
            echo "エラーメッセージ: " . $response['header']['error_message'] . "\n";
            $conn->close();
            break;
        case 'error':
            echo "エラー: " . $response['payload']['message'] . "\n";
            break;
        default:
            echo "不明なイベント: " . $response['header']['event'] . "\n";
            break;
    }

    // タスクが完了した場合、接続を閉じます
    if ($response['header']['event'] == 'task-finished') {
        // すべてのデータが確実に送信されるよう、1秒間待機します
        $loop->addTimer(1, function() use ($conn) {
            $conn->close();
            echo "クライアントが接続を閉じました\n";
        });
    }

    // task-started イベントが受信されていない場合、接続を閉じます
    if (!$taskStarted && in_array($response['header']['event'], ['task-failed', 'error'])) {
        $conn->close();
    }
}

Node.js

必要な依存関係をインストールします:

npm install ws
npm install uuid

サンプルコード:

// SSML 機能の説明:
//     1. run-task コマンドを送信する際に enable_ssml パラメーターを true に設定すると、SSML サポートが有効になります。
//     2. continue-task コマンドで SSML を含むテキストを送信します。continue-task コマンドは 1 回しか送信できません。
// SSML 対応のクローン音声またはプリセット音声を使用します(例:cosyvoice-v3-flash の longanyang)。対応モデルは本ページをご参照ください。

import fs from 'fs';
import WebSocket from 'ws';
import { v4 as uuid } from 'uuid'; // UUID を生成するために使用します

// シンガポールと北京リージョンの API キーは異なります。API キーの取得:https://www.alibabacloud.com/help/model-studio/get-api-key
// 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください:const apiKey = "sk-xxx"
const apiKey = process.env.DASHSCOPE_API_KEY;
// シンガポールリージョンの URL。WorkspaceId を実際のワークスペース ID に置き換えてください。URL はリージョンによって異なります。
const url = 'wss://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api-ws/v1/inference/';
// 出力ファイルパス
const outputFilePath = 'output.mp3';

// 出力ファイルをクリアします
fs.writeFileSync(outputFilePath, '');

// WebSocket クライアントを作成します
const ws = new WebSocket(url, {
  headers: {
    Authorization: `bearer ${apiKey}`,
    'X-DashScope-DataInspection': 'enable'
  }
});

let taskStarted = false;
let taskId = uuid();

ws.on('open', () => {
  console.log('Connected to WebSocket server');

  // run-task コマンドを送信します
  const runTaskMessage = JSON.stringify({
    header: {
      action: 'run-task',
      task_id: taskId,
      streaming: 'duplex'
    },
    payload: {
      task_group: 'audio',
      task: 'tts',
      function: 'SpeechSynthesizer',
      model: 'cosyvoice-v3-flash',
      parameters: {
        text_type: 'PlainText',
        voice: 'longanyang', // 音声
        format: 'mp3', // 音声フォーマット
        sample_rate: 22050, // サンプルレート
        volume: 50, // 音量
        rate: 1, // 話速
        pitch: 1, // ピッチ
        enable_ssml: true // SSML を有効にするかどうか。enable_ssml を true に設定した場合、continue-task コマンドは 1 回しか送信できません。そうでない場合は、エラー "Text request limit violated, expected 1." が返されます
      },
      input: {}
    }
  });
  ws.send(runTaskMessage);
  console.log('run-task message sent');
});

const fileStream = fs.createWriteStream(outputFilePath, { flags: 'a' });
ws.on('message', (data, isBinary) => {
  if (isBinary) {
    // バイナリデータをファイルに書き込みます
    fileStream.write(data);
  } else {
    const message = JSON.parse(data);

    switch (message.header.event) {
      case 'task-started':
        taskStarted = true;
        console.log('Task started');
        // continue-task コマンドを送信します
        sendContinueTasks(ws);
        break;
      case 'task-finished':
        console.log('Task completed');
        ws.close();
        fileStream.end(() => {
          console.log('File stream closed');
        });
        break;
      case 'task-failed':
        console.error('Task failed:', message.header.error_message);
        ws.close();
        fileStream.end(() => {
          console.log('File stream closed');
        });
        break;
      default:
        // result-generated はここで処理できます
        break;
    }
  }
});

function sendContinueTasks(ws) {

  if (taskStarted) {
    // continue-task コマンドを送信します。SSML を使用する場合、このコマンドは 1 回しか送信できません
    const continueTaskMessage = JSON.stringify({
      header: {
        action: 'continue-task',
        task_id: taskId,
        streaming: 'duplex'
      },
      payload: {
        input: {
          // 特殊文字はエスケープする必要があります
          text: '<speak rate="2">My speaking rate is faster than a normal person's.</speak>'
        }
      }
    });
    ws.send(continueTaskMessage);

    // finish-task コマンドを送信します
    const finishTaskMessage = JSON.stringify({
      header: {
        action: 'finish-task',
        task_id: taskId,
        streaming: 'duplex'
      },
      payload: {
        input: {}
      }
    });
    ws.send(finishTaskMessage);
  }
}

ws.on('close', () => {
  console.log('Disconnected from WebSocket server');
});

LaTeX

使用方法

数式を区切り文字で囲み、音声合成 API を呼び出します。

サポートする区切り文字(いずれも同じように機能します):

  • $...$
  • $$...$$
  • \(...\)
  • \[...\]

入力例:

这是一道分数:$\frac{1}{2}$。

この分数は中国語で「二分之一」(2 分の 1)と読み上げられます。

複数の演算子を含む数式にも同じ区切り文字を使用します。例:

这是一道一元二次方程的求根公式:$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$,请仔细计算。

JSON および Python、Java、JavaScript などの通常の文字列では、バックスラッシュ \ を \\ と記述します。例:LaTeX コマンド \frac は、通常の文字列では \\frac と記述します。

クイックスタート

この Python の例では、分数を含む中国語テキストを合成し、output.mp3 に保存します。API キーと SDK の準備方法は SSML のクイックスタートをご参照ください。

# coding=utf-8

import os

import dashscope

# 環境変数を設定していない場合は、次の行を Model Studio API キーに置き換えてください: api_key="sk-xxx"
# 以下はシンガポールリージョンの設定です。呼び出し時に "{WorkspaceId}" を実際のワークスペース ID に置き換えてください。設定はリージョンによって異なります。
client = dashscope.Client(
    api_key=os.environ.get('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

model = "cosyvoice-v3-flash"
voice = "longanyang"

# 通常の文字列では、バックスラッシュを \\ と記述します。
audio = client.audio.tts.synthesize("这是一道分数:$\\frac{1}{2}$。", model=model, voice=voice)

with open('output.mp3', 'wb') as f:
    f.write(audio)

SSML タグ

注記実装は W3C SSML 1.0 仕様に基づいています。以下に示すタグのみをサポートします。

<speak>:ルート要素

<speak> は、すべての SSML コンテンツのルート要素です。すべてのテキストは <speak></speak> タグで囲む必要があります。

<speak>SSML 処理が必要なテキスト</speak>

属性

属性

型

必須

説明

voice

String

いいえ

音声を指定します。

この属性は、API リクエストの voice パラメーターよりも優先されます。

rate

String

いいえ

読み上げ速度を指定します。この属性は、API リクエストの speech_rate パラメーターよりも優先されます。

  • 有効な値:0.5 から 2 までの小数 (両端を含む)

  • デフォルト値:1

    • 1 より大きい値は読み上げ速度を速めます
    • 1 より小さい値は読み上げ速度を遅めます

pitch

String

いいえ

ピッチを指定します。この属性は、API リクエストの pitch_rate パラメーターよりも優先されます。

  • 有効な値:0.5 から 2 までの小数 (両端を含む)

  • デフォルト値:1

    • 1 より大きい値はピッチを高くします
    • 1 より小さい値はピッチを低くします

volume

String

いいえ

音量を指定します。この属性は、API リクエストの volume パラメーターよりも優先されます。

  • 有効な値:0 から 100 までの整数 (両端を含む)

  • デフォルト値:50

    • 50 より大きい値は音量を大きくします
    • 50 より小さい値は音量を小さくします

effect

String

いいえ

オーディオエフェクトを指定します。

  • 有効な値:

    • robot:ロボット音声エフェクト
    • lolita:ロリータ音声エフェクト
    • lowpass:ローパスフィルターエフェクト
    • echo:エコーエフェクト
    • eq:イコライザー (高度)
    • lpfilter:ローパスフィルター (高度)
    • hpfilter:ハイパスフィルター (高度)

    注記

    • eq、lpfilter、hpfilter は高度なエフェクトタイプです。effectValue パラメーターを使用して特定のエフェクトをカスタマイズします。
    • 各 SSML タグは、1 つのエフェクトのみに対応します。複数の effect 属性を同時に設定することはできません。
    • オーディオエフェクトを有効にすると、合成レイテンシーが増加します。

effectValue

String

いいえ

オーディオエフェクト (effect パラメーター) の具体的な動作を設定します。eq、lpfilter、hpfilter の 3 つの高度なエフェクトタイプに適用されます。

  • 有効な値:

    • eq (イコライザー):システムはデフォルトで 8 つの周波数帯をサポートし、それぞれ次の周波数に対応します:

      ["40 Hz","100 Hz", "200 Hz", "400 Hz", "800 Hz", "1600 Hz", "4000 Hz", "12000 Hz"]

      各帯域の帯域幅は 1.0q です。

      effectValue パラメーターを使用して、各帯域のゲインを指定します。パラメーターは、-20 から 20 までの 8 つの整数をスペースで区切った文字列です。値 0 は、その周波数のゲイン調整がないことを意味します。

      例:effectValue="1 1 1 1 1 1 1 1"

    • lpfilter (ローパスフィルター):カットオフ周波数を指定します。有効な値:(0, target_sample_rate/2] の範囲内の整数。例:effectValue="800"

    • hpfilter (ハイパスフィルター):カットオフ周波数を指定します。有効な値:(0, target_sample_rate/2] の範囲内の整数。例:effectValue="1200"

bgm

String

いいえ

合成音声に背景音楽を追加します。

音声ファイルを Alibaba Cloud OSS に保存し、インターネット URL からアクセスできるようにします。オブジェクトのアップロードをご参照ください。非公開ファイルには有効な署名付き URL を使用できます。URL 内の XML 特殊文字はエスケープします(例:& を &amp; に置換)。

  • 音声要件:

    BGM ファイルのサイズに上限はありませんが、ファイルサイズが大きいほどダウンロードに時間がかかります。合成音声が BGM より長い場合、BGM は自動的にループします。

    • サンプルレート:16 kHz

    • チャネル:モノラル

    • フォーマット:WAV

      WAV 以外のファイルを変換するには、ffmpeg を使用します:

      ffmpeg -i input_audio -acodec pcm_s16le -ac 1 -ar 16000 output.wav
      
    • ビット深度:16 ビット

重要アップロードした音声の著作権に関する法的責任は、アップロード者が負います。

backgroundMusicVolume

String

いいえ

BGM の音量を指定します。この属性は bgm 属性と一緒に使用します。

例

属性なし

<speak>
  SSML タグが必要なテキスト
</speak>

属性の組み合わせ (スペース区切り)

<speak rate="1.5" pitch="0.8" volume="80">
  すべてを組み合わせると、私の声はこんな風に聞こえます。
</speak>

voice

<speak voice="longcheng_v2">
  私は男性の声です。
</speak>

rate

<speak rate="2">
  私の読み上げ速度は通常より速いです。
</speak>

pitch

<speak pitch="0.5">
  しかし、私のピッチは他の人より低いです。
</speak>

volume

<speak volume="80">
  私の音量もとても大きいです。
</speak>

effect

<speak effect="robot">
  ロボットのウォーリーは好きですか?
</speak>

effectValue

<speak effect="eq" effectValue="1 -20 1 1 1 1 20 1">
  ロボットのウォーリーは好きですか?
</speak>

<speak effect="lpfilter" effectValue="1200">
  ロボットのウォーリーは好きですか?
</speak>

<speak effect="hpfilter" effectValue="1200">
  ロボットのウォーリーは好きですか?
</speak>

bgm

<speak bgm="https://nls.alicdn.com/bgm/2.wav" backgroundMusicVolume="30" rate="0.8" volume="40">
  <break time="2s"/>
  陰崖の古木は霧に包まれ
  <break time="700ms"/>
  雨音はなお竹林に響く
  <break time="700ms"/>
  我知る、綿は国の計に資すると
  <break time="700ms"/>
  綿州の景色は常に憐れむべし
  <break time="2s"/>
</speak>

タグの関係

<speak> タグは、テキストと次の子タグを含むことができます:

  • <break>:一時停止の時間を制御する
  • <sub>:テキストを置換する
  • <phoneme>:発音 (ピンイン/音声表記) を指定する
  • <soundEvent>:外部の音 (着信音、猫の鳴き声など) を挿入する
  • <say-as>:テキストの解釈 (数字、日付、電話番号など) を設定する

<break>:間の制御

音声合成中に無音のポーズを挿入し、会話における自然な間をシミュレートします。時間単位として、秒 (s) とミリ秒 (ms) をサポートします。

<!-- 属性なし -->
<break/>
<!-- time 属性あり -->
<break time="string"/>

属性

属性

型

必須

説明

time

文字列

いいえ

ポーズ期間を秒またはミリ秒で指定します (例: "2s" または "50ms")。

  • 有効な値:

    • 秒 (s) 単位:1 から 10 までの整数 (両端の値を含む)
    • ミリ秒 (ms) 単位:50 から 10000 までの整数 (両端の値を含む)

複数の <break> タグが連続して使用された場合、合計ポーズ期間は各期間の合計になります。合計が 10 秒を超える場合、10 秒に短縮されます。

属性なしの <break> は、デフォルトで 1 秒間停止します。

例

time

<speak>
  目を閉じて、休憩してください。<break time="500ms"/>はい、目を開けてください。
</speak>

以下の 3 つの <break> タグを連続して使用すると、設定上の合計停止時間は 15 秒になりますが、実際の停止時間は 10 秒に制限されます。

<speak>
  目を閉じて、休憩してください。<break time="5s"/><break time="5s"/><break time="5s"/>はい、目を開けてください。
</speak>

タグの関係

<break> は空要素であり、子要素を含むことはできません。

<sub>:テキストの置換

指定されたテキストを、音声での読み上げに適したコンテンツに置き換えます。例えば、「W3C」を「World Wide Web コンソーシアム」として読み上げます。

<sub alias="string"></sub>

属性

属性

タイプ

必須

説明

エイリアス

文字列

はい

読み上げる代替テキストを指定します。

例

エイリアス

<speak>
  <sub alias="World Wide Web コンソーシアム">W3C</sub>
</speak>

タグの関係

<sub> タグは、プレーンテキストのみを含めることができます。

<phoneme>:発音の指定

テキストの発音を正確に制御します。中国語テキストではピンイン表記、英語テキストでは CMU 発音記号をサポートします。これは、多音字の曖昧さを解消したり、外国語の発音を処理したりするのに役立ちます。

<phoneme alphabet="文字列" ph="文字列">テキスト</phoneme>

属性

属性

タイプ

必須

説明

alphabet

文字列

はい

発音のタイプを指定します:ピンイン (中国語の場合) または発音記号 (英語の場合)。

有効な値:

  • "py": ピンイン
  • "cmu": 発音記号。CMU 発音辞書 をご参照ください

ph

文字列

はい

正確なピンインまたは発音記号を指定します。使用ルール:

  • 複数の文字に対応するピンインは、スペースで区切ります。ピンインの数は文字数と一致する必要があります。
  • 各ピンインは、発音と声調番号で構成されます。声調番号の範囲は 1 から 5 で、5 は軽声を表します。

例

ph

<speak>
  去<phoneme alphabet="py" ph="dian3 dang4 hang2">典当行</phoneme>把这个玩意<phoneme alphabet="py" ph="dang4 diao4">当掉</phoneme>
</speak>

<speak>
  How to spell <phoneme alphabet="cmu" ph="S AY N">sin</phoneme>?
</speak>

タグの関係

<phoneme> タグには、プレーンテキストのみを含めることができます。

<soundEvent>:効果音の挿入

音声の特定のポイントに効果音ファイル (アラート音や環境音など) を挿入して、オーディオ出力を豊かにします。

<soundEvent src="URL"/>

属性

属性

タイプ

必須

説明

src

文字列

必須

外部音声ファイルの URL を指定します。

音声ファイルを Alibaba Cloud OSS に保存し、インターネット URL からアクセスできるようにします。オブジェクトのアップロードをご参照ください。非公開ファイルには有効な署名付き URL を使用できます。URL 内の XML 特殊文字はエスケープします(例:& を &amp; に置換)。

  • 音声要件:

    • サンプリングレート:16 kHz

    • チャンネル:モノラル

    • フォーマット:WAV

      WAV 形式以外のファイルを変換するには、ffmpeg を使用します:

      ffmpeg -i input_audio -acodec pcm_s16le -ac 1 -ar 16000 output.wav
      
    • ファイルサイズ:最大 2 MB

    • ビット深度:16 ビット

重要アップロードした音声の著作権に関する法的責任は、アップロード者が負います。

例

src

<speak>
  馬が驚き、<soundEvent src="https://nls.alicdn.com/sound-event/horse-neigh.wav"/>人々は避けるために散らばりました。
</speak>

タグの関係

<soundEvent> は空要素であり、子要素を含めることはできません。

<say-as>:読み方の指定

テキストのコンテンツタイプ (数値、日付、電話番号など) を指定すると、システムはそのタイプに応じた適切なルールに従ってテキストを読み上げます。

<say-as interpret-as="string">Text</say-as>

属性

属性

タイプ

必須

説明

interpret-as

文字列

はい

タグ内のテキストのコンテンツタイプを指定します。

有効な値:

  • cardinal :基数。標準的な整数または小数として読み上げます
  • digits :各数字を個別に読み上げます (例:123 は「いち に さん」と読み上げます)
  • telephone :標準的な電話番号形式で数字を 1 つずつ読み上げます
  • name :標準的な名前の発音ルールで読み上げます
  • address :標準的な住所の発音ルールで読み上げます
  • id :標準的な識別子 (アカウント名、ニックネーム) の発音ルールで読み上げます
  • characters :テキスト内の各文字を個別に読み上げます
  • punctuation :各句読点の名前を読み上げます
  • date :標準的な日付の発音ルールで読み上げます
  • time :標準的な時刻の発音ルールで読み上げます
  • currency :標準的な金額の発音ルールで読み上げます
  • measure :標準的な単位の発音ルールで読み上げます

say-as がサポートする形式を表示

cardinal

中国語

形式

例

中国語出力

説明

数字列

145

一百四十五

正負の整数は 20 桁以内:[-99999999999999999999,99999999999999999999]。小数点以下の桁数に特定の制限はありませんが、10 桁以内を推奨します。

マイナス記号+数値列

-145

负一百四十五

カンマで区切った 3 桁の数字列

10,000

一万

マイナス記号+カンマで区切った 3 桁の数値列

-10,124

负一万一百二十四

数値列+小数点+2 つのゼロ

10.00

十

マイナス記号+数値列+小数点+2 つのゼロ

-110.00

负一百一十

数値列+小数点+数値列

79.090

七十九点零九零

マイナス記号+数値列+小数点+数値列

-79.001

负七十九点零零一

英語

フォーマット

例

英語の出力

注記

数字列

145

one hundred forty five

整数の範囲:最大 13 桁までの正負の整数、[-999999999999,999999999999]。

小数の範囲:小数点以下の桁数に制限はありませんが、10 桁以下を推奨します。

先頭が 0 の数字列

0145

one hundred forty five

マイナス符号 + 数字列

-145

minus one hundred forty five

3桁ごとにカンマで区切られた数字列

60,000

sixty thousand

マイナス符号 + カンマ区切りの数字列

-208,000

minus two hundred eight thousand

数字列 + 小数点 + 0

12.00

twelve

数字列 + 小数点 + 数字列

12.34

twelve point three four

カンマ区切りの数字列 + 小数点 + 数字列

1,000.1

one thousand point one

マイナス符号 + 数字列 + 小数点 + 数字列

-12.34

minus twelve point three four

マイナス符号 + カンマ区切りの数字列 + 小数点 + 数字列

-1,000.1

minus one thousand point one

(カンマ区切りの) 数字列 + ハイフン + (カンマ区切りの) 数字列

1-1,000

one to one thousand

その他のデフォルトの読み上げ

012.34

twelve point three four

なし

1/2

one half

-3/4

minus three quarters

5.1/6

five point one over six

-3 1/2

minus three and a half

1,000.3^3

one thousand point three to the power of three

3e9.1

three times ten to the power of nine point one

23.10%

twenty three point one percent

digits

中国語

形式

例

中国語出力

説明

数字列

129090909

一二九零九零九零九

数字列の長さに特定の制限はありませんが、20 桁以内を推奨します。10 桁を超える場合、各数字の後に間を挿入します。

英語

フォーマット

例

英語の出力

注

数字列

12034

one two zero three four

数字列の長さに特定の制限はありませんが、20 桁以下を推奨します。

数字列がスペースまたはハイフンでグループ化されている場合、グループ間に休止を示すカンマが挿入されます。最大 5 つのグループまで対応しています。

数字列 + スペース/ハイフン + 数字列 + スペース/ハイフン + 数字列 + スペース/ハイフン + 数字列

1-23-456 7890

one, two three, four five six, seven eight nine zero

telephone

中国語

形式

例

中国語出力

説明

固定電話番号

4930286

四九三 零二八六

7~8 桁の固定電話番号に対応し、区切りにはスペースまたはハイフン(-)を使用できます。7 桁は 3-4、8 桁は 4-4 の区切りに対応します。

493 0286

四九三 零二八六

493-0286

四九三 零二八六

62552560

六二五五 二五六零

6255 2560

六二五五 二五六零

6255-2560

六二五五 二五六零

固定電話番号+内線番号

4930286-109

四九三 零二八六 转幺零九

1~4 桁の内線番号に対応します。

4930286转109

四九三 零二八六 转幺零九

4930286分机109

四九三 零二八六 分机幺零九

4930286分机号109

四九三 零二八六 分机号幺零九

市外局番+固定電話番号

01062552560

零幺零 六二五五 二五六零

対応する市外局番:010、02x、03xx、04xx、05xx、07xx、08xx、09xx。

010 62552560

零幺零 六二五五 二五六零

010 6255 2560

零幺零 六二五五 二五六零

010 6255-2560

零幺零 六二五五 二五六零

010-62552560

零幺零 六二五五 二五六零

010-6255-2560

零幺零 六二五五 二五六零

(010)62552560

零幺零 六二五五 二五六零

03198907098

零三幺九 八九零 七零九八

0319-8907098

三幺九 八九零 七零九八

市外局番+固定電話番号+内線番号

010 62552560-109

零幺零 六二五五 二五六零 转幺零九

なし

010-62552560-109

零幺零 六二五五 二五六零 转幺零九

(010)62552560-109

零幺零 六二五五 二五六零 转幺零九

(010)62552560转109

零幺零 六二五五 二五六零 转幺零九

(010)62552560分机109

零幺零 六二五五 二五六零 分机幺零九

(010)62552560分机号109

零幺零 六二五五 二五六零 分机号幺零九

国番号+市外局番+固定電話番号

86-010-62791627

八六 零幺零 六二七九 幺六二七

国番号 86、(86)、+86、(+86)、0086 は、すべて「八六」と読み上げられます。

(86)10-62791627

八六 幺零 六二七九 幺六二七

+86-010-62791627

八六 零幺零 六二七九 幺六二七

0086-10-62791627

八六 幺零 六二七九 幺六二七

(+86)-10-6279 1627

八六 幺零 六二七九 幺六二七

国番号+市外局番+固定電話番号+内線番号

(86)21-58118818-207

八六 二幺 五八幺幺 八八幺八 转二零七

なし

(86)021-5811-8818-207

八六 零二幺 五八幺幺 八八幺八 转二零七

(86)021-58118818转207

八六 零二幺 五八幺幺 八八幺八 转二零七

(86)21-5811-8818分机207

八六 二幺 五八幺幺 八八幺八 分机二零七

+86-021-58118818分机号207

八六 零二幺 五八幺幺 八八幺八分机号二零七

携帯電話番号

139 0000 5678

幺三九 零零零零 五六七八

11 桁の携帯電話番号に対応し、3-3-5 または 3-4-4 で区切れます。

139-000-05678

幺三九 零零零 零五六七八

139 000 05678

幺三九 零零零 零五六七八

国番号+携帯電話番号

+86-13900005678

八六 幺三九 零零零零 五六七八

なし

(+86)-139-0000-5678

八六 幺三九 零零零零 五六七八

+8613900005678

八六 幺三九 零零零零 五六七八

0086-139 000 05678

八六 幺三九 零零零 零五六七八

サービス番号

123

幺二三

一般的なサービス番号に対応します。400/800 で始まる 10 桁の番号は 3-3-4 の区切りに対応し、12530/17951/12593 で始まる 16 桁の番号にも対応します。

95678

九五六七八

4008110510

四零零 八幺幺 零五幺零

800-810-8888

八零零 八幺零 八八八八

1253013520638377

幺二五三零 幺三五 二零六三 八三七七

その他

(86)(21)9899-80800-0909

八六 二幺 九八九九 八零八零零 零九零九

数字列と区切り文字(括弧、ハイフン)を組み合わせた形式に対応します。

英語

フォーマット

例

英語の出力

備考

数字文字列

12034

one two oh three four

数字文字列の長さに特定の制限はありませんが、20 桁以下を推奨します。数字文字列がスペースまたはハイフンでグループ化されている場合、グループ間にカンマによるポーズが挿入されます。5 つのグループまでサポートします。

数字文字列 + スペース/ハイフン + 数字文字列 + スペース/ハイフン + 数字文字列

1-23-456 7890

one, two three, four five six, seven eight nine oh

プラス記号 + 数字文字列 + スペース/ハイフン + 数字文字列

+43-211-0567

plus four three, two one one, oh five six seven

左括弧 + 数字文字列 + 右括弧 + スペース + 数字文字列 + スペース/ハイフン + 数字文字列

(21) 654-3210

two one, six five four, three two one oh

address

中国語

形式

例

中国語出力

説明

一般的な住所形式

元和镇嘉元30-9

元和镇嘉元三十杠九

一般的な住所形式に対応します。ここでの住所は標準的な郵送先住所を指します。

市台路388弄1107-1108号

市台路三八八弄幺幺零七杠幺幺零八号

华润二十四城六期锦云府3-1-3205

华润二十四城六期锦云府三杠一杠三二零五

圣华名都大厦2幢2006室

圣华名都大厦二幢二零零六室

五常街道庭院5幢4单元201

五常街道庭院五幢四单元二零幺

芙蓉江路150弄19号

芙蓉江路幺五零弄十九号

英語

英語テキストでは、このタイプはサポートされていません。

id

中国語

形式

例

中国語出力

説明

文字列

dell0101

D E L L 零 一 零 一

英大文字・小文字、数字 0~9、アンダースコアに対応します。出力内のスペースは、1 文字ずつ読む際の間を表します。

myid_1998

M Y I D 下划线 一 九 九 八

AiTest

A I T E S T

英語

英語テキストでは、このタイプは characters と同じように機能します。

characters

中国語

形式

例

中国語出力

説明

文字列

ISBN 1-001-099098-1

I S B N 一 杠 零 零 一 杠 零 九 九 零 九 八 杠 一

漢字、英大文字・小文字、数字 0~9、一部の全角・半角文字に対応します。スペースは、1 文字ずつ読む際の間を表します。XML 特殊文字はエスケープしてください。

x10b2345_u

x 一 零 b 二 三 四 五 下划线 u

v1.0.1

v 一 点 零 点 一

版本号2.0

版本号二 点 零

苏M MA000

苏M M A 零 零 零

空中客车A330

空中客车A 三 三 零

型号s01 s02和s03

型号s 零 一 s 零二 和s 零 三

空中客车A330

空中客车A 三 三 零

αβγ

阿尔法 贝塔 伽玛

英語

フォーマット

例

英語の出力

備考

文字列

*b+3$.c-0'=α

asterisk B plus three dollar dot C dash zero apostrophe equals alpha

中国語の文字、大文字と小文字、数字の 0~9、および一部の全角文字と半角文字をサポートします。

出力のスペースは文字間のポーズを表すもので、各文字が個別に読み上げられることを意味します。

タグ内のテキストに XML 特殊文字が含まれる場合は、エスケープしてください。

punctuation

中国語

形式

例

中国語出力

説明

句読点

…

省略号

一般的な中国語・英語の句読点に対応します。スペースは、1 文字ずつ読む際の間を表します。XML 特殊文字はエスケープしてください。

……

省略号

!"#$%&

叹号 双引号 井号 dollar 百分号 and

‘()*+

单引号 左括号 右括号 星号 加号

,-./:;

逗号 杠 点 斜杠 冒号 分号

<=>?@

小于 等号 大于 问号 at

[\]^_

左方括号 反斜线 右方括号 脱字符 下划线

英語

英語テキストでは、このタイプは characters と同じように機能します。

date

中国語

形式

例

中国語出力

説明

xx年

71年

七一年

2 桁の年は 60~99、00~09、10~19、4 桁の年は 1000~1999、2000~2099 に対応します。

04年

零四年

19年

一九年

1011年

一零一一年

1998年

一九九八年

2008年

二零零八年

xx年xx月

98年4月

九八年四月

1~9 月では先頭の 0 の有無を選べます。例:「1908年4月」「1908年04月」。

1998年04月

一九九八年四月

08年8月

零八年八月

2008年8月

二零零八年八月

xx年xx月xx日xx年xx月xx号

98年4月23日

九八年四月二十三日

1~9 日では先頭の 0 の有無を選べます。例:「1908年4月8日」「1908年04月08日」。

1998年04月23日

一九九八年四月二十三日

08年8月8号

零八年八月八号

2008年08月08号

二零零八年八月八号

xx年xx月xx日xx年xx月xx号

98年4月23日

九八年四月二十三日

1~9 日では先頭の 0 の有無を選べます。例:「1908年4月8日」「1908年04月08日」。

1998年04月23日

一九九八年四月二十三日

08年8月8号

零八年八月八号

2008年08月08号

二零零八年八月八号

xx月xx号

3月20日

三月二十日

なし

08月07号

八月七号

年月の省略形

2018/08

二零一八年八月

省略形の区切りには /、-、. を使用できます。

2018-08

二零一八年八月

2018.08

二零一八年八月

年月日の省略形

2018/08/08

二零一八年八月八日

2018-8-8

二零一八年八月八日

2018.08.08

二零一八年八月八日

xx年xx月xx日~xx年xx月xx日xx年xx月xx号~xx年xx月xx号

04年9月1日~30日

零四年九月一日至三十日

「から~まで」を表す記号として ~ と - に対応します。

2004年09月01号-2008年06月08号

二零零四年九月一号至二零零八年六月八号

xx年xx月xx日~xx日xx年xx月xx号~xx号

04年9月1日~30日

零四年九月一日至三十日

2004年09月01号-2008年06月08号

二零零四年九月一号至二零零八年六月八号

xx年xx月~xx年xx月

01年04月~10年04月

零一年四月至一零年四月

2001年04月~2010年04月

二零零一年四月至二零一零年四月

xx月xx日~xx月xx日xx月xx号~xx月xx号

10月1日~10月7日

十月一日至十月七日

10月01号~10月07号

十月一号至十月七号

xx月xx日~xx日xx月xx号~xx号

10月1日~7日

十月一日至七日

10月01号~07号

十月一号至七号

年月日の省略形~年月日の省略形

2018/03/03~2019/01/01

二零一八年三月三日至二零一九年一月一日

区切りには / と .、「から~まで」を表す記号には ~ と - を使用できます。

1997.9.9~1998.9.9

一九九七年九月九日至一九九八年九月九日

月日の省略形~月日の省略形

10/20~10/31

十月二十日至十月三十一日

xx~xx月xx月~xx月

1~10月

一至十月

1月~10月

一月至十月

月日年の省略形

10/20/2018

二零一八年十月二十日

4 桁の年、区切り /、月/日/年の順序のみをサポートします。

英語

フォーマット

例

英語の出力

備考

4 桁/2 桁、または 4 桁-2 桁

2000/01

two thousand, oh one

年をまたぐ表記。

1900-01

nineteen hundred, oh one

2001-02

twenty oh one, oh two

2019-20

twenty nineteen, twenty

1998-99

nineteen ninety eight, ninety nine

1999-00

nineteen ninety nine, oh oh

1 または 2 で始まる 4 桁の数値

2000

two thousand

4 桁の年。

1900

nineteen hundred

1905

nineteen oh five

2021

twenty twenty-one

曜日の範囲 (ハイフン)

または

曜日の範囲 (チルダ)

または

曜日&曜日

mon-wed

monday to wednesday

曜日の範囲を指定するテキストに XML の特殊文字が含まれる場合は、文字をエスケープしてください。

tue~fri

tuesday to friday

sat&sun

saturday and sunday

DD-DD MMM, YYYY

または

DD~DD MMM, YYYY

または

DD&DD MMM, YYYY

19-20 Jan, 2000

the nineteen to the twentieth of january two thousand

DD:2 桁の日。MMM:3 文字の月の略語または月名。YYYY:1 または 2 で始まる 4 桁の年。

01 ~ 10 Jul, 2020

the first to the tenth of july twenty

05&06 Apr, 2009

the fifth and the sixth of april two thousand nine

MMM DD-DD

または

MMM DD~DD

または

MMM DD&DD

Feb 01 - 03

february the first to the third

MMM:3 文字の月の略語または月名。DD:2 桁の日。

Aug 10~20

august the tenth to the twentieth

Dec 11&12

december the eleventh and the twelfth

MMM-MMM

または

MMM~MMM

または

MMM&MMM

Jan-Jun

january to june

MMM:3 文字の月の略語または月名。

jul ~ dec

july to december

sep&oct

september and october

YYYY-YYYY

または

YYYY~YYYY

1990 - 2000

nineteen ninety to two thousand

YYYY:1 または 2 で始まる 4 桁の年。

2001~2021

two thousand one to twenty twenty-one

WWW DD MMM YYYY

Sun 20 Nov 2011

sunday the twentieth of november twenty eleven

WWW は曜日の 3 文字の略語または曜日名、DD は 2 桁の日、MMM は月の 3 文字の略語または月名、MM は 2 桁の月 (または月の 3 文字の略語または月名) 、YYYY は 1 または 2 で始まる 4 桁の年です。

WWW DD MMM

Sun 20 Nov

sunday the twentieth of november

WWW MMM DD YYYY

Sun Nov 20 2011

sunday november the twentieth twenty eleven

WWW MMM DD

Sun Nov 20

sunday november the twentieth

WWW YYYY-MM-DD

Sat 2010-10-01

saturday october the first twenty ten

WWW YYYY/MM/DD

Sat 2010/10/01

saturday october the first twenty ten

WWW MM/DD/YYYY

Sun 11/20/2011

sunday november the twentieth twenty eleven

MM/DD/YYYY

11/20/2011

november the twentieth twenty eleven

YYYY

1998

nineteen ninety eight

その他のデフォルトの読み上げ

10 Mar, 2001

the tenth of march two thousand one

なし

10 Mar

the tenth of march

Mar 2001

march two thousand one

Fri. 10/Mar/2001

friday the tenth of march two thousand one

Mar 10th, 2001

march the tenth two thousand one

Mar 10

march the tenth

2001/03/10

march the tenth two thousand one

2001-03-10

march the tenth two thousand one

2000s

two thousands

2010's

twenty tens

1900's

nineteen hundreds

1990s

nineteen nineties

time

中国語

形式

例

中国語出力

説明

時刻

12:00

十二点

一般的な時刻と時刻範囲の形式に対応します。

12:00:00点

十二点

10:20分

十点二十分

10:20:30

十点二十分三十秒

09:18:14

九点十八分十四秒

時刻~時刻

11:00~12:00

十一点到十二点

09:00-14:00

九点到十四点

11:00~11:30

十一点到十一点三十分

11:00-12:18

十一点到十二点十八分

10:30~11:00

十点三十分到十一点

09:28-10:00

九点二十八分到十点

10:20~11:20

十点二十分到十一点二十分

06:00~08:00

六点到八点

上午10:20~下午13:30

上午十点二十分到下午十三点三十分

時刻の省略形

5:00 am

凌晨五点整

5:30 am

凌晨五点半

5:20:12 am

凌晨五点二十分十二秒

7:00 am

上午七点整

7:30 AM

上午七点半

7:20:12 a.m.

上午七点二十分十二秒

07:08:12 A.M.

上午七点零八分十二秒

5:00 pm

下午五点整

5:30 PM

下午五点半

5:20:12 p.m.

下午五点二十分十二秒

05:09:12 P.M.

下午五点零九分十二秒

9:00 pm

晚上九点整

9:30 pm

晚上九点半

9:20:12 PM

晚上九点二十分十二秒

9:02:12 P.M.

晚上九点零二分十二秒

12:00 pm

中午十二点整

12:30 p.m.

中午十二点半

12:20:12 PM

中午十二点二十分十二秒

英語

フォーマット

例

英語の出力

備考

HH:MM AM または PM

09:00 AM

nine A M

HH: 時 (1桁または2桁)。MM: 分 (2桁)。AM/PM: 午前/午後。

09:03 PM

nine oh three P M

09:13 p.m.

nine thirteen p m

HH:MM

21:00

twenty one hundred

HHMM

0100

one hundred

時刻の範囲

8:00 am - 05:30 pm

eight a m to five thirty p m

一般的な時刻フォーマットと範囲をサポートします。

7:05~10:15 AM

seven oh five to ten fifteen A M

09:00-13:00

nine oclock to thirteen hundred

currency

中国語

形式

例

中国語出力

説明

数値+通貨識別子

12.00 RMB

十二人民币

AUD(豪ドル)、CAD(カナダドル)、HKD(香港ドル)、JPY(円)、USD(米ドル)、CHF(スイスフラン)、NOK(ノルウェークローネ)、SEK(スウェーデンクローナ)、GBP(英ポンド)、RMB(人民元)、CNY(元)、EUR(ユーロ)に対応します。整数、小数、カンマ区切りの国際表記を使用できます。

12.50 RMB

十二点五零人民币

12,000,000 RMB

一千二百万人民币

12,000,000.00 RMB

一千二百万人民币

12,000.35 RMB

一万两千点三五人民币

通貨識別子+数値

$12

十二美元

CAD(カナダドル)、$(米ドル)、Fr(フラン)、kr(デンマーククローネ)、£(英ポンド)、¥(元)、€(ユーロ)に対応します。整数、小数、カンマ区切りの国際表記を使用できます。

$12.00

十二美元

$12.12

二点一二美元

$12,000

一万两千美元

$12,000.00

一万两千美元

$12,000.99

一万两千点九九美元

その他のデフォルトの読み方

1213

一千二百一十三

なし

1213 KML

一千二百一十三K M L

1213.00 KML

一千二百一十三K M L

1213.9 KML

一千二百一十三点九K M L

1,000 KML

一千K M L

1,000.00 KML

一千K M L

1,000.98 KML

一千点九八K M L

12,000

一万两千

英語

フォーマット

例

英語出力

備考

数値 + 通貨識別子

1.00 RMB

one yuan

サポートされている数値フォーマット:整数、小数、カンマ区切りの国際表記。

サポートされている通貨識別子:

CN¥ (元)

CNY (元)

RMB (元)

AUD (オーストラリアドル)

CAD (カナダドル)

CHF (スイスフラン)

DKK (デンマーククローネ)

EUR (ユーロ)

GBP (英ポンド)

HKD (香港ドル)

JPY (日本円)

NOK (ノルウェークローネ)

SEK (スウェーデンクローナ)

SGD (シンガポールドル)

USD (米ドル)

2.02 CNY

two point zero two yuan

1,000.23 CN¥

one thousand point two three yuan

1.01 SGD

one singapore dollar and one cent

2.01 CAD

two canadian dollars and one cent

3.1 HKD

three hong kong dollars and ten cents

1,000.00 EUR

one thousand euros

通貨識別子 + 数値

US$ 1.00

one US dollar

サポートされている数値フォーマット:整数、小数、カンマ区切りの国際表記。

サポートされている通貨識別子:

US$ (米ドル)

CA$ (カナダドル)

AU$ (オーストラリアドル)

SG$ (シンガポールドル)

HK$ (香港ドル)

C$ (カナダドル)

A$ (オーストラリアドル)

$ (ドル)

£ (ポンド)

€ (ユーロ)

CN¥ (元)

CNY (元)

RMB (元)

AUD (オーストラリアドル)

CAD (カナダドル)

CHF (スイスフラン)

DKK (デンマーククローネ)

EUR (ユーロ)

GBP (英ポンド)

HKD (香港ドル)

JPY (日本円)

NOK (ノルウェークローネ)

SEK (スウェーデンクローナ)

SGD (シンガポールドル)

USD (米ドル)

$0.01

one cent

JPY 1.01

one japanese yen and one sen

£1.1

one pound and ten pence

€2.01

two euros and one cent

USD 1,000

one thousand united states dollars

数値 + 分類子 + 通貨識別子

または

通貨識別子 + 数値 + 分類子

1.23 Tn RMB

one point two three trillion yuan

サポートされている分類子フォーマット:

サウザンド

ミリオン

ビリオン

トリリオン

Mil (ミリオン)

mil (ミリオン)

Bil (ビリオン)

bil (ビリオン)

MM (ミリオン)

Bn (ビリオン)

bn (ビリオン)

Tn (トリリオン)

tn (トリリオン)

K (サウザンド)

k (サウザンド)

M (ミリオン)

m (ミリオン)

$1.2 K

one point two thousand dollars

measure

中国語

形式

例

中国語出力

説明

数値+中国語の単位

2片

两片

一般的な中国語の単位と単位の略語に対応します。

120公顷

一百二十公顷

100多毫克

一百多毫克

100来米

一百来米

100余人

一百余人

1厘米20毫米

一厘米二十毫米

120.00平方公里

一百二十平方公里

数値+単位の略語

120.56 cm²

一百二十点五六平方厘米

120 ㎡ 56 cm²

一百二十平方米五十六平方厘米

100 m 12 cm 6 mm

一百米十二厘米六毫米

範囲

10~15 kg

十至十五千克

10.24~789.82亩

十点二四至七百八十九点八二亩

10米~15米

十米至十五米

10.24 cm~19.08 cm

十点二四厘米至十九点零八厘米

数値+単位+"/"+単位

10元/斤

十元每斤

199~299元/件

一百九十九至二百九十九元每件

299.99元/g~399.99元/g

二百九十九点九九元每克至三百九十九点九九元每克

その他のデフォルトの読み方

12扎

十二扎

30 rm

三十r m

4万万同胞

四万万同胞

12.897微克

十二点八九七微克

英語

フォーマット

例

英語出力

備考

数値 + 測定単位

1.0 kg

one kilogram

サポートされている数値フォーマットは、整数、小数、およびカンマ区切りの国際表記です。

一般的な単位の省略形をサポートします。

1,234.01 km

one thousand two hundred thirty four point zero one kilometres.

測定単位

mm2

square millimetre

一般的な記号

記号

中国語の読み方

英語の読み方

!

叹号

exclamation mark

“

双引号

double quote

#

井号

pound

$

dollar

dollar

%

百分号

percent

&

and

and

‘

单引号

left quote

(

左括号

left parenthesis

)

右括号

right parenthesis

*

星

asterisk

+

加

plus

,

逗号

comma

-

杠

dash

.

点

dot

/

斜杠

slash

:

零冒号

solon

;

分号

semicolon

<

小于

less than

=

等号

equals

>

大于

greater than

?

问号

question mark

@

at

at

[

左方括号

left bracket

\

反斜线

back slash

]

右方括号

right bracket

^

脱字符

caret

_

下划线

underscore

`

反引号

back quote

{

左花括号

left brace

|

竖线

vertical bar

}

右花括号

right brace

~

波浪线

tilde

!

叹号

exclamation mark

“

左双引号

left double quote

”

右双引号

right double qute

‘

左单引号

left quote

’

右单引号

right quote

(

左括号

left parenthesis

)

右括号

right parenthesis

,

逗号

comma

。

句号

full stop

—

杠

em dash

:

冒号

colon

;

分号

semicolon

?

问号

question mark

、

顿号

enumeration comma

…

省略号

ellipsis

……

省略号

ellipsis

《

左书名号

left guillemet

》

右书名号

right guillemet

¥

人民币符号

yuan

≥

大于等于

greater than or equal to

≤

小于等于

less than or equal to

≠

不等于

not equal

≈

约等于

approximately equal

±

加减

plus or minus

×

乘

times

π

派

pi

Α

阿尔法

alpha

Β

贝塔

beta

Γ

伽玛

gamma

Δ

德尔塔

delta

Ε

艾普西龙

epsilon

Ζ

捷塔

zeta

Θ

西塔

theta

Ι

艾欧塔

iota

Κ

喀帕

kappa

∧

拉姆达

lambda

Μ

缪

mu

Ν

拗

nu

Ξ

克西

ksi

Ο

欧麦克轮

omicron

∏

派

pi

Ρ

柔

rho

∑

西格玛

sigma

Τ

套

tau

Υ

宇普西龙

upsilon

Φ

fai

phi

Χ

器

chi

Ψ

普赛

psi

Ω

欧米伽

omega

α

阿尔法

alpha

β

贝塔

beta

γ

伽玛

gamma

δ

德尔塔

delta

ε

艾普西龙

epsilon

ζ

捷塔

zeta

η

依塔

eta

θ

西塔

theta

ι

艾欧塔

iota

κ

喀帕

kappa

λ

拉姆达

lambda

μ

缪

mu

ν

拗

nu

ξ

克西

ksi

ο

欧麦克轮

omicron

π

派

pi

ρ

柔

rho

σ

西格玛

sigma

τ

套

tau

υ

宇普西龙

upsilon

φ

fai

phi

χ

器

chi

ψ

普赛

psi

ω

欧米伽

omega

一般的な単位

形式

カテゴリ

中国語の例

英語の例

略語

長さ

nm(纳米)、μm(微米)、 mm(毫米)、cm(厘米)、m(米)、km(千米)、ft(英尺)、in(英寸)

nm (nanometre), μm (micrometre), mm (millimetre), cm (centimetre), m (metre), km (kilometre), ft (foot), in (inch)

面積

cm²(平方厘米)、㎡(平方米)、km²(平方千米)、SqFt(平方英尺)

cm² (square centimetre), ㎡ (square metre), km2 (square kilometre), SqFt (square foot)

体積

cm³(立方厘米)、m³(立方米)、km³(立方千米)、mL(毫升)、L(升)、gallon(加仑)

cm³ (cubic centimetre), m³ (cubic metre), km3 (cubic kilometre), mL (millilitre), L (millilitre), gal (gallon)

重さ

μg(微克)、mg(毫克)、g(克)、kg(千克)

μg (microgram), mg (microgram), g (gram), kg (kilogram)

時間

min(分)、sec(秒)、ms(毫秒)

min (minute), sec (second), ms (millisecond)

電磁気

μA(微安)、mA(毫安)、Ω(欧姆)、Hz(赫兹)、kHz(千赫兹)、MHz(兆赫兹)、GHz(吉赫兹)、V(伏)、kV(千伏)、kWh(千瓦时)

μA (microamp), mA (milliamp), Hz (hertz), kHz (kilohertz), MHz (megahertz), GHz (gigahertz), V (volt), kV (kilovolt), kWh (kilowatt hour)

音

dB(分贝)

dB (decibel)

気圧

Pa(帕)、kPa(千帕)、Mpa(兆帕)

Pa (pascal), kPa (kilopascal), MPa (megapascal)

その他の一般的な単位

上記以外にも「米」「秒」「美元」「毫升每瓶」などの中国語の単位や、「架」「场」「头」「部」「盆」などの中国語の助数詞に対応します。

上記以外にも tsp (teaspoon)、rpm (round per minute)、KB (kilobyte)、mmHg (millimetre of mercury) などの単位に対応します。

例

cardinal

<speak>
  <say-as interpret-as="cardinal">12345</say-as>
</speak>
<speak>
  <say-as interpret-as="cardinal">10234</say-as>
</speak>

digits

<speak>
  <say-as interpret-as="digits">12345</say-as>
</speak>
<speak>
  <say-as interpret-as="digits">10234</say-as>
</speak>

telephone

<speak>
  <say-as interpret-as="telephone">12345</say-as>
</speak>
<speak>
  <say-as interpret-as="telephone">10234</say-as>
</speak>

name

<speak>
  她的曾用名是<say-as interpret-as="name">曾小凡</say-as>
</speak>

address

<speak>
  <say-as interpret-as="address">富路国际1号楼3单元304</say-as>
</speak>

id

<speak>
  <say-as interpret-as="id">myid_1998</say-as>
</speak>

characters

<speak>
  <say-as interpret-as="characters">希腊字母αβ</say-as>
</speak>
<speak>
  <say-as interpret-as="characters">*b+3.c$=α</say-as>
</speak>

punctuation

<speak>
  <say-as interpret-as="punctuation"> -./:;</say-as>
</speak>

date

<speak>
  <say-as interpret-as="date">1000-10-10</say-as>
</speak>
<speak>
  <say-as interpret-as="date">10-01-2020</say-as>
</speak>

time

<speak>
  <say-as interpret-as="time">5:00am</say-as>
</speak>
<speak>
  <say-as interpret-as="time">0500</say-as>
</speak>

currency

<speak>
  <say-as interpret-as="currency">13,000,000.00RMB</say-as>
</speak>
<speak>
  <say-as interpret-as="currency">$1,000.01</say-as>
</speak>

measure

<speak>
  <say-as interpret-as="measure">100m12cm6mm</say-as>
</speak>
<speak>
  <say-as interpret-as="measure">1,000.01kg</say-as>
</speak>

タグの関係

<say-as> タグにはテキストを含めることができます。

LaTeX のタグと記号

カテゴリを選んで、サポートするタグと記号を確認してください。入力例には区切り文字が含まれます。この機能は中国語音声を生成するため、読み方の例は中国語のまま記載しています。

基礎数学

タグまたは記号

意味

数式ソースの例

入力テキストの例

読み方の例

+

加算

2 + 3 = 5

$2 + 3 = 5$

二加三等于五

-

減算

3 - 2 = 1

$3 - 2 = 1$

三减二等于一

\pm

加減

\pm 1 \pm 2

$\pm 1\pm 2$

正负一加减二

正負

\times

乗算

2 \times 3 = 6

$2 \times 3 = 6$

二乘三等于六

×

2 × 3 = 6

$$2 × 3 = 6$$

*

2 * 3 = 6

\(2 * 3 = 6\)

\div

除算

6\div2=3

\[6\div2=3\]

六除二等于三

÷

6÷2=3

$6÷2=3$

/

6/2=3

$6/2=3$

=

等号

3+5=8

$3+5=8$

三加五等于八

<

より小さい

1< 2

$1< 2$

一小于二

≤

以下

3≤5

$3≤5$

三小于等于五

<=

3<=5

$3<=5$

\leq

3\leq5

$3\leq 5$

\le

3\le5

$3\le 5$

\leqq

3\leqq5

$3\leqq 5$

\leqslant

3\leqslant5

$3\leqslant 5$

>

より大きい

2>1

$2>1$

二大于一

≥

以上

5≥3

$5≥3$

五大于等于三

>=

5>=3

$5>=3$

\geq

5\geq3

$5\geq 3$

\ge

5\ge3

$5\ge 3$

\geqq

5\geqq3

$5\geqq 3$

\geqslant

5\geqslant3

$5\geqslant 3$

\frac

分数

2\frac3

$\frac {2}{3}$

三分之二

^

累乗

2^1

$2^{1}$

二的一次方

\sqrt

根

\sqrt{9} = 3

$\sqrt {9} = 3$

根号下九等于三

\sqrt[3]{8} = 2

$\sqrt[3]{8} = 2$

三次根号下八等于二

\%

百分率

5\%

$5\%$

百分之五

|

絶対値

∣3∣=3

$|3| =3$

绝对值三的绝对值等于三

\vert

3\vert=3

$\vert 3\vert =3$

绝对值三绝对值等于三

\lg

対数

lg {10}

$\lg {10}$

log十

\log

対数

\log{5}

$\log{5}$

log五

\ln

自然対数

\lnX

$ln {10}$

LN十

!

階乗

5!

$5!$

五的阶乘

()

括弧

(2+1)

$(2+1)$

括号内二加一

\{ \}

$\{2+1\}$

大括号二加一反大括号

特殊数学記号

タグまたは記号

意味

数式ソースの例

入力テキストの例

読み方の例

\alpha

alpha

\alpha

$\alpha$

α

\Alpha

\Alpha

$\Alpha$

\beta

beta

\beta

$\beta$

β

\Beta

\Beta

$\Beta$

\gamma

gamma

\gamma

$\gamma$

γ

\Gamma

\Gamma

$\Gamma$

\delta

delta

\delta

$\delta$

Δ

\Delta

\Delta

$\Delta$

\infty

無限大(中国語)

\infty

$\infty$

无穷大

∞

infty(英語)

∞

$∞$

幾何

タグまたは記号

意味

数式ソースの例

入力テキストの例

読み方の例

\pi

円周率

\pi=3.14159

$\pi =3.14159$

派等于三点一四一五九

\sin (sine)

三角関数

\sin 30^\circ =\frac {1}{2}

$\sin 30^\circ =\frac {1}{2}$

sine三十度等于二分之一

\cos (cosine)

\cos 45^\circ =\frac {\sqrt {2}}{2}

$\cos 45^\circ =\frac {\sqrt {2}}{2}$

cosine四十五度等于二分之根号下二

\tan (tangent)

\tan 30^\circ =\frac {\sin 30^\circ}{\cos 30^\circ}

$\tan 30^\circ =\frac {\sin 30^\circ}{\cos 30^\circ}$

tangent三十度等于cosine三十度分之sine三十度

\csc (cosecant)

\csc A

$\csc A$

cosecant A

\sec (secant)

\sec A

$\sec A$

secant A

\cot (cotangent)

\cot A

$\cot A$

cotangent A

\angle

角

\angle AB

$\angle AB$

角A B

∠

∠AB

$∠AB$

^\circ

度

∠AB = 30^\circ

$∠AB = 30^\circ$

角A B 等于三十度

\odot

円

\odot

$\odot$

圆

\overset\frown

弧

\overset\frown {BC}

$\overset\frown {BC}$

弧BC

\rm{Rt}

直角

\because \rm{Rt}\triangle ABC

$\because \rm{Rt}\triangle ABC$

因为直角三角形ABC

\mathrm{Rt}

\therefore AB \perp BC

$\therefore AB \perp BC$

所以AB垂直于BC

\triangle

三角形

\triangleABC

$\triangle ABC$

三角形ABC

△

△ABC

$△ABC$

\parallelogram

平行四辺形

\parallelogramABCD

$\parallelogram ABCD$

平行四边形ABCD

\perp

垂直

AB \perp BC

$AB \perp BC$

A B 垂直于 B C

\bot

AB \bot BC

$AB \bot BC$

⊥

AB ⊥ BC

$AB ⊥ BC$

\parallel

平行

A\parallel B

$A\parallel B$

A平行于B

\equalparallel

平行かつ等しい

A\equalparallel B

$A\equalparallel B$

A平行且相等于B

\cong

合同

△ABC\cong△DEF

$△ABC\cong△DEF$

三角形ABC全等于三角形DEF

条件

タグまたは記号

意味

数式ソースの例

入力テキストの例

読み方の例

\implies

導く

\implies 1+1=2

$\implies 1+1=2$

推出一加一等于二

\iff

同値

p\iffq

$p\iffq$

p等价q

\because

なぜなら

\because a = b \therefore b=a

$\because a = b \therefore b=a$

因为a等于b所以b等于a

\therefore

したがって

単位

単位は \unit、\quantity、\mathit、\mathrm、\rm のいずれかで囲みます。例:\unit{cm}。

タグまたは記号

意味

数式ソースの例

入力テキストの例

読み方の例

mm

ミリメートル

5\quantity{mm}

$5\quantity{mm}$

五毫米

cm

センチメートル

5\quantity{cm}

$5\quantity{cm}$

五厘米

dm

デシメートル

5\quantity{dm}

$5\quantity{dm}$

五分米

m

メートル

5\quantity{m}

$5\quantity{m}$

五米

km

キロメートル

5\quantity{km}

$5\quantity{km}$

五千米

g

グラム

5\quantity{g}

$5\quantity{g}$

五克

kg

キログラム

5\quantity{kg}

$5\quantity{kg}$

五千克

t

トン

5\quantity{t}

$5\quantity{t}$

五吨

mm^2

平方ミリメートル

5\quantity{mm^2}

$5\quantity{mm^2}$

五平方毫米

cm^2

平方センチメートル

5\quantity{cm^2}

$5\quantity{cm^2}$

五平方厘米

dm^2

平方デシメートル

5\quantity{dm^2}

$5\quantity{dm^2}$

五平方分米

m^2

平方メートル

5\quantity{m^2}

$5\quantity{m^2}$

五平方米

km^2

平方キロメートル

5\quantity{km^2}

$5\quantity{km^2}$

五平方千米

mm^3

立方ミリメートル

5\quantity{mm^3}

$5\quantity{mm^3}$

五立方毫米

cm^3

立方センチメートル

5\quantity{cm^3}

$5\quantity{cm^3}$

五立方厘米

dm^3

立方デシメートル

5\quantity{dm^3}

$5\quantity{dm^3}$

五立方分米

m^3

立方メートル

5\quantity{m^3}

$5\quantity{m^3}$

五立方米

km^3

立方キロメートル

5\quantity{km^3}

$5\quantity{km^3}$

五立方千米

ml

ミリリットル

5\quantity{ml}

$5\quantity{ml}$

五毫升

s

秒

5\quantity{s}

$5\quantity{s}$

五秒

min

分

5\quantity{min}

$5\quantity{min}$

五分

h

時間

5\quantity{h}

$5\quantity{h}$

五小时

km/h

キロメートル毎時

5\quantity{km/h}

$5\quantity{km/h}$

五千米每小时

g/l

グラム毎リットル

5\quantity{g/l}

$5\quantity{g/l}$

五克每升

よくある質問

数式が正しく読み上げられない場合は?

  1. 数式が $...$、$$...$$、\(...\)、\[...\] のいずれかで囲まれているか確認します。
  2. サポートされていないタグや記号がないか確認します。
  3. リクエストの文字列で \ が \\ とエスケープされているか確認します。

コード内のバックスラッシュはどう記述しますか?

使用方法のエスケープに関する説明をご参照ください。数式ソースとコード内の文字列では記述方法が異なります。例:\frac は通常の文字列では \\frac と記述します。