音声合成 API
提供中さまざまな声と言語で、自然なナレーションを。
コードから 音声合成 API を呼び出す
上のすべてのモデルを 1 つのエンドポイントで。model フィールドを変えるだけで切り替えられます。
https:/ / api.opennan.com/ v1/ audio/ speech- GET
/このエンドポイントの全モデルと料金v1/ models? category= voice
API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/audio/speech \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"kokoro","input":"こんにちは!この音声は 1 回の API 呼び出しで作られました。","voice":"heart","response_format":"mp3"}' \ --output speech.mp3結果を読む
結果は同じレスポンスで返ります。X-Usage-Cost-Usd ヘッダーに呼び出しの料金が入ります。
パラメーター
公開中のカタログから作成: ここにある値はすべて API が受け付けます。
エラーと直し方
401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。
AI アプリに Opennan を追加
一度の設定で、AI が Opennan のすべてのツールを使えます:動画、画像、チャット、音声、音楽、効果音、3D、字幕、吹き替え。お使いのアプリを選んで手順に従ってください。
https:/ / api.opennan.com/ v1/ mcpCodex CLI、Codex アプリ、Codex の IDE 拡張で使えます(共通の ~/.codex/config.toml)。アプリや IDE が OPENNAN_KEY を読めない場合は、キーを書いた config.toml の方法を使ってください。Codex はツールを呼ぶ前に確認するので、承認して続けます。
キーを OPENNAN_KEY として保存
# macOS / Linux (zsh shown; bash: ~/.bashrc) echo 'export OPENNAN_KEY="sk-..."' >> ~/.zshrc source ~/.zshrc # Windows (PowerShell), then open a new terminal setx OPENNAN_KEY "sk-..."Opennan プラグインをインストール:サーバーと、モデル選び・価格確認・結果待ちを AI に教えるスキルが入ります
codex plugin marketplace add Opennan/opennan-ai-plugin codex plugin add opennan@opennanまたはサーバーだけを追加
codex mcp add opennan --url https://api.opennan.com/v1/mcp --bearer-token-env-var OPENNAN_KEYまたは ~/.codex/config.toml にこれを追加
[mcp_servers.opennan] url = "https://api.opennan.com/v1/mcp" http_headers = { Authorization = "Bearer sk-..." }opennan が一覧にあるか確認
codex mcp listCodex を再起動して、何でも頼んでください
“ネオン街に降る雨の 5 秒動画と、それに合う曲とポスター画像を作って。”
sk-... をご自身のキーに置き換え、他人に見せないでください。キーを持つ人は残高を使えます。キーがなくてもツール一覧は表示できますが、生成にはキーが必要です。
AI エージェントから使う
エージェントに Opennan の MCP サーバーを追加して、このツールを呼び出します。
- ツール
- generate_speech
- 引数の例
{ "model": "kokoro", "input": "こんにちは!この音声は 1 回の API 呼び出しで作られました。", "voice": "heart" }
音声合成 API: よくある質問
音声合成 API の料金は?
Kokoro で 100万文字あたり $1.287 から。ここにある 4 モデルの中で最安です。料金は実行前に表示されます。
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/audio/speech を送ります。結果は同じレスポンスで返ります。
コードを変えずにモデルを切り替えられますか?
はい。model フィールドを変えるだけで、リクエストの残り、キー、残高はそのままです。
AI エージェントから使えますか?
はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して generate_speech ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。
実行が失敗したら?
失敗した実行には料金がかかりません。支払いは結果に対してだけです。