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 特殊文字をエスケープします:
"→"、'→'、&→&、<→<、>→>。
クイックスタート
次の例では、SSML を使用して合成音声の話す速度を制御します。コードを実行する前に、次の前提条件を満たしてください:
- API キーの取得
- 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-WebSocketjackson-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>
属性
属性 | 型 | 必須 | 説明 |
|---|---|---|---|
| String | いいえ | 音声を指定します。 この属性は、API リクエストの
|
| String | いいえ | 読み上げ速度を指定します。この属性は、API リクエストの
|
| String | いいえ | ピッチを指定します。この属性は、API リクエストの
|
| String | いいえ | 音量を指定します。この属性は、API リクエストの
|
| String | いいえ | オーディオエフェクトを指定します。
|
| String | いいえ | オーディオエフェクト (
|
| String | いいえ | 合成音声に背景音楽を追加します。 音声ファイルを Alibaba Cloud OSS に保存し、インターネット URL からアクセスできるようにします。オブジェクトのアップロードをご参照ください。非公開ファイルには有効な署名付き URL を使用できます。URL 内の XML 特殊文字はエスケープします(例:
重要アップロードした音声の著作権に関する法的責任は、アップロード者が負います。 |
| String | いいえ | 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"/>
属性
属性 | 型 | 必須 | 説明 |
|---|---|---|---|
| 文字列 | いいえ | ポーズ期間を秒またはミリ秒で指定します (例: "2s" または "50ms")。
複数の |
属性なしの <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>
属性
属性 | タイプ | 必須 | 説明 |
|---|---|---|---|
| 文字列 | はい | 発音のタイプを指定します:ピンイン (中国語の場合) または発音記号 (英語の場合)。 有効な値:
|
| 文字列 | はい | 正確なピンインまたは発音記号を指定します。使用ルール:
|
例
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"/>
属性
属性 | タイプ | 必須 | 説明 |
|---|---|---|---|
| 文字列 | 必須 | 外部音声ファイルの URL を指定します。 音声ファイルを Alibaba Cloud OSS に保存し、インターネット URL からアクセスできるようにします。オブジェクトのアップロードをご参照ください。非公開ファイルには有効な署名付き URL を使用できます。URL 内の XML 特殊文字はエスケープします(例:
重要アップロードした音声の著作権に関する法的責任は、アップロード者が負います。 |
例
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>
属性
属性 | タイプ | 必須 | 説明 |
|---|---|---|---|
| 文字列 | はい | タグ内のテキストのコンテンツタイプを指定します。 有効な値:
|
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 のタグと記号
カテゴリを選んで、サポートするタグと記号を確認してください。入力例には区切り文字が含まれます。この機能は中国語音声を生成するため、読み方の例は中国語のまま記載しています。
基礎数学
タグまたは記号 | 意味 | 数式ソースの例 | 入力テキストの例 | 読み方の例 |
|---|---|---|---|---|
| 加算 |
|
| 二加三等于五 |
| 減算 |
|
| 三减二等于一 |
| 加減 |
|
| 正负一加减二 |
正負 | ||||
| 乗算 |
|
| 二乘三等于六 |
|
|
| ||
|
|
| ||
| 除算 |
|
| 六除二等于三 |
|
|
| ||
|
|
| ||
| 等号 |
|
| 三加五等于八 |
| より小さい |
|
| 一小于二 |
| 以下 |
|
| 三小于等于五 |
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
| より大きい |
|
| 二大于一 |
| 以上 |
|
| 五大于等于三 |
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
|
|
| ||
| 分数 |
|
| 三分之二 |
| 累乗 |
|
| 二的一次方 |
| 根 |
|
| 根号下九等于三 |
|
| 三次根号下八等于二 | ||
| 百分率 |
|
| 百分之五 |
| 絶対値 |
|
| 绝对值三的绝对值等于三 |
|
|
| 绝对值三绝对值等于三 | |
| 対数 |
|
| log十 |
| 対数 |
|
| log五 |
| 自然対数 |
|
| LN十 |
| 階乗 |
|
| 五的阶乘 |
| 括弧 |
|
| 括号内二加一 |
|
| 大括号二加一反大括号 |
特殊数学記号
タグまたは記号 | 意味 | 数式ソースの例 | 入力テキストの例 | 読み方の例 |
|---|---|---|---|---|
| alpha |
|
| α |
|
|
| ||
| beta |
|
| β |
|
|
| ||
| gamma |
|
| γ |
|
|
| ||
| delta |
|
| Δ |
|
|
| ||
| 無限大(中国語) |
|
| 无穷大 |
| infty(英語) |
|
|
幾何
タグまたは記号 | 意味 | 数式ソースの例 | 入力テキストの例 | 読み方の例 |
|---|---|---|---|---|
| 円周率 |
|
| 派等于三点一四一五九 |
| 三角関数 |
|
| sine三十度等于二分之一 |
|
|
| cosine四十五度等于二分之根号下二 | |
|
|
| tangent三十度等于cosine三十度分之sine三十度 | |
|
|
| cosecant A | |
|
|
| secant A | |
|
|
| cotangent A | |
| 角 |
|
| 角A B |
|
|
| ||
| 度 |
|
| 角A B 等于三十度 |
| 円 |
|
| 圆 |
| 弧 |
|
| 弧BC |
| 直角 |
|
| 因为直角三角形ABC |
|
|
| 所以AB垂直于BC | |
| 三角形 |
|
| 三角形ABC |
|
|
| ||
| 平行四辺形 |
|
| 平行四边形ABCD |
| 垂直 |
|
| A B 垂直于 B C |
|
|
| ||
|
|
| ||
| 平行 |
|
| A平行于B |
| 平行かつ等しい |
|
| A平行且相等于B |
| 合同 |
|
| 三角形ABC全等于三角形DEF |
条件
タグまたは記号 | 意味 | 数式ソースの例 | 入力テキストの例 | 読み方の例 |
|---|---|---|---|---|
| 導く |
|
| 推出一加一等于二 |
| 同値 |
|
| p等价q |
| なぜなら |
|
| 因为a等于b所以b等于a |
| したがって |
単位
単位は \unit、\quantity、\mathit、\mathrm、\rm のいずれかで囲みます。例:\unit{cm}。
タグまたは記号 | 意味 | 数式ソースの例 | 入力テキストの例 | 読み方の例 |
|---|---|---|---|---|
| ミリメートル |
|
| 五毫米 |
| センチメートル |
|
| 五厘米 |
| デシメートル |
|
| 五分米 |
| メートル |
|
| 五米 |
| キロメートル |
|
| 五千米 |
| グラム |
|
| 五克 |
| キログラム |
|
| 五千克 |
| トン |
|
| 五吨 |
| 平方ミリメートル |
|
| 五平方毫米 |
| 平方センチメートル |
|
| 五平方厘米 |
| 平方デシメートル |
|
| 五平方分米 |
| 平方メートル |
|
| 五平方米 |
| 平方キロメートル |
|
| 五平方千米 |
| 立方ミリメートル |
|
| 五立方毫米 |
| 立方センチメートル |
|
| 五立方厘米 |
| 立方デシメートル |
|
| 五立方分米 |
| 立方メートル |
|
| 五立方米 |
| 立方キロメートル |
|
| 五立方千米 |
| ミリリットル |
|
| 五毫升 |
| 秒 |
|
| 五秒 |
| 分 |
|
| 五分 |
| 時間 |
|
| 五小时 |
| キロメートル毎時 |
|
| 五千米每小时 |
| グラム毎リットル |
|
| 五克每升 |
よくある質問
数式が正しく読み上げられない場合は?
- 数式が
$...$、$$...$$、\(...\)、\[...\]のいずれかで囲まれているか確認します。 - サポートされていないタグや記号がないか確認します。
- リクエストの文字列で
\が\\とエスケープされているか確認します。
コード内のバックスラッシュはどう記述しますか?
使用方法のエスケープに関する説明をご参照ください。数式ソースとコード内の文字列では記述方法が異なります。例:\frac は通常の文字列では \\frac と記述します。