標準 TTS API

1. アクセストークンを取得する

標準 TTS API を利用するには アクセストークン（64 文字） が必要です。アカウント登録後、設定ページから取得できます。

1. 音読さんに登録 / ログイン
2. アクセストークン取得ページ を開く
3. 「アクセストークン」欄に表示されている 64 文字の文字列をコピー

このページのサンプルでは環境変数 ONDOKU_TOKEN にトークンが入っている前提で書いています。

2. エンドポイント・リクエスト仕様

ヘッダー

ボディ（JSON）

4 項目とも必須です。1 つでも欠けると HTTP 400 になります。

レスポンス

成功時は application/json で生成音声の URL と履歴 ID が返ります。MP3 バイナリは url にアクセスして取得してください。

{
  "text": "こんにちは、音読さんです。",
  "url": "https://storage.googleapis.com/ondoku3/voice/...",
  "pk": 12345,
  "share": 1
}

失敗時は多くの場合 JSON で {"error": "..."} が返ります。レート制限時のみ reset_in が追加されます。

3. サンプルコード

curl -X POST https://ondoku3.com/text_to_speech_api/ \
  -H "Content-Type: application/json" \
  -H "token: $ONDOKU_TOKEN" \
  -d '{
    "voice": "ja-JP-NanamiNeural",
    "text": "こんにちは、音読さんです。",
    "speed": 1.0,
    "pitch": 0.0
  }' \
  | tee response.json
curl -L "$(jq -r .url response.json)" -o output.mp3

import os
import requests

resp = requests.post(
    "https://ondoku3.com/text_to_speech_api/",
    headers={
        "Content-Type": "application/json",
        "token": os.environ["ONDOKU_TOKEN"],
    },
    json={
        "voice": "ja-JP-NanamiNeural",
        "text": "こんにちは、音読さんです。",
        "speed": 1.0,
        "pitch": 0.0,
    },
    timeout=60,
)
resp.raise_for_status()

data = resp.json()
mp3 = requests.get(data["url"], timeout=60).content
with open("output.mp3", "wb") as f:
    f.write(mp3)
print(f"saved: output.mp3 ({len(mp3)} bytes), pk={data['pk']}")

import { writeFile } from "node:fs/promises";

const token = process.env.ONDOKU_TOKEN!;

const res = await fetch("https://ondoku3.com/text_to_speech_api/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    token,
  },
  body: JSON.stringify({
    voice: "ja-JP-NanamiNeural",
    text: "こんにちは、音読さんです。",
    speed: 1.0,
    pitch: 0.0,
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);

type StandardTTSResponse = {
  text: string;
  url: string;
  pk: number;
  share: number;
};

const data = (await res.json()) as StandardTTSResponse;
const audioRes = await fetch(data.url);
if (!audioRes.ok) throw new Error(`audio HTTP ${audioRes.status}: ${await audioRes.text()}`);
const buf = Buffer.from(await audioRes.arrayBuffer());
await writeFile("output.mp3", buf);
console.log(`saved: output.mp3 (${buf.byteLength} bytes), pk=${data.pk}`);

4. エラー・案内レスポンス

5. レート制限と利用上限

• レート制限: 60 秒あたり 30 リクエスト（接続元 IP 単位。同じ IP から複数のトークンを使っても共有）
• 月間利用文字数: プランごとに上限あり。設定ページで消費量を確認できる
• 商用利用: 可能（詳細は利用規約）

6. 使用上の注意事項

アクセストークンの管理

• アクセストークン漏洩時の責任はユーザー側にあります。第三者があなたの月間文字数を消費してしまう可能性があるため、Git リポジトリ・公開チャット・スクリーンショット等への混入に注意してください
• 漏洩を検知したら即座に 設定ページ から再発行してください
• 本番アプリに直接組み込む前に、専用の開発用アカウントでトークン発行と疎通確認を行うことを推奨します

入力テキスト・生成音声の取り扱い

• 送信したテキストと生成された音声は、サービス運営上必要な期間サーバー側に保持されます（履歴機能のため）
• 個人情報・機密情報・社外秘の文書をそのまま送信しないでください。送信前に匿名化・抽象化することを推奨します
• 履歴は 履歴ページ から削除できます

リトライ指針

同時実行・並列度

• レート制限は 60 秒 / 30 リクエスト（接続元 IP 単位。同じ IP から複数のトークンを使っても共有）。並列実行する場合は同時 3 〜 5 並列程度を目安に
• 大量バッチで月間文字数を一気に消費しないよう、事前に処理見積もりと残文字数の確認を

タイムアウト推奨値

• クライアント側の HTTP タイムアウト: 30 〜 60 秒（長文ほど生成時間がかかる）
• サーバー側でも内部タイムアウトがあるため、それを超える時間レスポンスを待っても返りません

CORS（ブラウザから直接叩く場合）

• このエンドポイントは CORS を開放していません。ブラウザ JS から直接 fetch すると CORS エラーになります
• サーバー側（Node.js / Python / PHP 等）からプロキシしてください

コンテンツポリシー

以下の用途での利用を禁止します:

• 詐欺・なりすまし・他者の声の複製を目的とした音声生成
• 違法行為・差別・ヘイトスピーチ・他者への嫌がらせを含むコンテンツの生成
• 不適切なディープフェイクの素材として利用すること

詳細は 利用規約 を確認してください。

生成音声の著作権・商用利用

• API 経由で生成された音声も、Web UI で生成した音声と同じ条件で利用できます
• 商用利用は可能ですが、音声を再販・二次配布する形態（音声素材として販売する等）は規約を確認してください

7. SLA（稼働率）

音読さんの公式 API は、API ごとに次の月間稼働率を SLA として提供します。この節の定義（数え方・停止に含めないもの・下回った場合の扱い）は両 API に共通です。

SLA の対象は稼働率のみで、応答時間は含みません。

稼働率の数え方

• 日本時間の暦月（1 日 0:00 〜 月末 24:00）ごとに数えます
• 5 分間を 1 区間とし、その 5 分間に API へのリクエストがあり、すべてがサーバーエラー（HTTP 5xx）だった区間を停止とします
• Advanced TTS API は、ジョブの作成（POST）とポーリング（GET）の両方のリクエストを数えます。音声生成の失敗（ポーリング結果のジョブの status が failed）は停止に数えません
• 月間稼働率 =（その月の区間数 − 停止区間数）÷ その月の区間数

停止に含めないもの

• 事前に告知した計画メンテナンス
• 音声合成の提供元やクラウド基盤の障害
• 利用者側に原因があるもの（不正なリクエスト、レート制限、利用可能文字数の不足など HTTP 4xx になるもの）
• 天災・戦争・通信回線の障害など、当社の合理的な管理を超える事由

SLA を下回った場合

• 月間稼働率がその API の SLA の値（上の表）を下回った月について、有料プランのご利用者から翌月末までに申請があった場合、その月のご利用プランの月間利用可能文字数の 10% を付与します
• 申請は お問い合わせ から、対象の月と、ご登録のメールアドレスを添えてご連絡ください
• 現金での返金は行いません。SLA を下回った場合の対応は、この文字数の付与に限ります

8. 変更履歴

互換性を壊す変更（項目の削除・型や意味の変更・エンドポイントの廃止など）は、実施の 30 日前にこの節で告知します。項目や声の追加など互換を保つ主な変更も、実施後にこの節に記録します（事前告知はしません）。緊急のセキュリティ対応は例外です。

9. 問い合わせ前に

不具合や予期しない挙動を確認したら、まず以下を試してください:

1. エラー・案内内容を確認: エラー・案内レスポンス 表で対応を確認
2. リトライ: 一時的なネットワーク・サーバー側エラーの可能性
3. 残文字数を確認: 設定ページ で月間文字数の消費量を確認
4. 最小ペイロードで疎通テスト: {"voice":"ja-JP-NanamiNeural","text":"テスト","speed":1.0,"pitch":0.0} で 200 が返るか
5. トークン再発行: 認証エラーが解消しない場合、設定ページから新しいトークンを発行

上記で解消しない場合は お問い合わせ からご連絡ください。再現に必要な以下の情報を添えていただけるとスムーズです:

• リクエストの voice / text の長さ / speed / pitch
• レスポンスの HTTP ステータスとボディ（トークンは伏せてください）
• 発生日時（タイムゾーン付き）