音楽生成 API
提供中動画のためのオリジナル BGM とスコア。
入力
promptスタイル、雰囲気、楽器、テンポ。instrumental歌あり。あなたの歌詞か、作成した歌詞で歌います。追加料金なしlyrics書いたとおりに歌います。空欄なら歌詞を作成します。duration30 秒30 秒30 秒
音楽生成 API のモデルを比較
このエンドポイントの全モデルを最新料金で。プレイグラウンドで試すか、各モデルのページを開けます。
- CassetteAI Sound EffectsCassetteAI1トラックあたり $0.013最安
- ACE-StepACE Studio & StepFun音声1分あたり $0.0156
- CassetteAI MusicCassetteAI音声1分あたり $0.026(開始した1分ごとに課金)
- Stable Audio 3 Small SFXStability AI1トラックあたり $0.02678
- Stable Audio 3 SmallStability AI1トラックあたり $0.02821
- Stable Audio 3Stability AI1トラックあたり $0.048881トラックあたり $0.08-38%
コードから 音楽生成 API を呼び出す
上のすべてのモデルを 1 つのエンドポイントで。model フィールドを変えるだけで切り替えられます。
https:/ / api.opennan.com/ v1/ music/ generations- GET
/このエンドポイントの全モデルと料金v1/ models? category= music
API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成最初のリクエストを送る
プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。
curl https://api.opennan.com/v1/music/generations \ -H "Authorization: Bearer $OPENNAN_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"ace-step","prompt":"あたたかい Lo-fi ヒップホップ、やわらかなピアノ、レコードのノイズ、ゆったりしたテンポ","duration":30,"instrumental":true}' # Then poll until "status" is "succeeded" or "failed": curl https://api.opennan.com/v1/tasks/<task id> -H "Authorization: Bearer $OPENNAN_KEY"タスクを確認する
呼び出すとすぐにタスク ID が返ります。終わるまでタスクを確認します:
GEThttps:// api.opennan.com/ v1/ tasks/ {id} - queued
- ワーカーの空き待ち
- running
- 生成中
- succeeded
- 完了: outputs[].url にファイルがあります
- failed
- 失敗: 料金はかかりません
パラメーター
公開中のカタログから作成: ここにある値はすべて 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_music
- 引数の例
{ "model": "ace-step", "prompt": "あたたかい Lo-fi ヒップホップ、やわらかなピアノ、レコードのノイズ、ゆったりしたテンポ", "duration": 30 }
音楽生成 API: よくある質問
音楽生成 API の料金は?
ACE-Step で 音声1分あたり $0.0156 から。ここにある 4 モデルの中で最安です。料金は実行前に表示されます。
コードから呼び出すには?
API キーを付けて POST https://api.opennan.com/v1/music/generations を送ります。タスク ID が返るので、成功か失敗になるまで https://api.opennan.com/v1/tasks/{id} を確認します。
コードを変えずにモデルを切り替えられますか?
はい。model フィールドを変えるだけで、リクエストの残り、キー、残高はそのままです。
AI エージェントから使えますか?
はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して generate_music ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。
実行が失敗したら?
失敗した実行には料金がかかりません。支払いは結果に対してだけです。