Sound effects

提供中

Describe a sound. Get it back as audio in the same response: footsteps on gravel, heavy rain, a door slam, a whoosh, up to 22 seconds long.

$0.0026 per secondFailed runs are not charged.

Sound effects

入力

Describe the soundtextThe sound to make.

45 / 1,000

Lengthduration_secondsSeconds of sound.5 s

Formatresponse_format

$0.0026 per started second.

5 s5 s

例

出力の例

Sound effects

0:00 / 0:00

仕組み

01Describe the soundWhat it is and how it should feel, up to 1,000 characters.
02We make itOne sound, as long as you ask for.
03Get the audioMP3, WAV or Opus, in the same response.

コードから Sound effects を呼び出す

One endpoint and one key, on the same balance as the playground. The request below is the example's own.

POSThttps://api.opennan.com/v1/audio/sound-effects

API キーを取得
コンソールでキーを作成します。プレイグラウンドと同じ残高を使います。
キーを作成

最初のリクエストを送る

プレイグラウンドが送るのと同じリクエストです。OPENNAN_KEY にキーを設定してください。

curl https://api.opennan.com/v1/audio/sound-effects \
  -H "Authorization: Bearer $OPENNAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"heavy rain on a tin roof with distant thunder","duration_seconds":5}' \
  --output sound.mp3

結果を読む
結果は同じレスポンスで返ります。X-Usage-Cost-Usd ヘッダーに呼び出しの料金が入ります。

エラーと直し方

401キーがない、または間違っている
コンソールで作ったキーを Authorization: Bearer ヘッダーで送ってください。
402残高不足
請求ページで残高を追加し、同じ呼び出しをもう一度送ってください。
400受け付けられない値がある
error.message にフィールド名が出ます。パラメーター表の値を使ってください。
429リクエストが多すぎる
数秒待ってから再試行し、429 が続くたびに待ち時間を延ばしてください。

AI アプリに Opennan を追加

一度の設定で、AI が Opennan のすべてのツールを使えます：動画、画像、チャット、音声、音楽、効果音、3D、字幕、吹き替え。お使いのアプリを選んで手順に従ってください。

MCP サーバーhttps://api.opennan.com/v1/mcp

Codex CLI、Codex アプリ、Codex の IDE 拡張で使えます（共通の ~/.codex/config.toml）。アプリや IDE が OPENNAN_KEY を読めない場合は、キーを書いた config.toml の方法を使ってください。Codex はツールを呼ぶ前に確認するので、承認して続けます。

API キーを取得
コンソールでキーを作成します。sk- で始まり、サイトと同じ残高を使います。
キーを作成

キーを 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-..."

3
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-..." }

4
opennan が一覧にあるか確認
```
codex mcp list
```
Codex を再起動して、何でも頼んでください
“ネオン街に降る雨の 5 秒動画と、それに合う曲とポスター画像を作って。”

sk-... をご自身のキーに置き換え、他人に見せないでください。キーを持つ人は残高を使えます。キーがなくてもツール一覧は表示できますが、生成にはキーが必要です。

AI エージェントから使う

エージェントに Opennan の MCP サーバーを追加して、このツールを呼び出します。

ツール: generate_sfx
引数の例: { "text": "heavy rain on a tin roof with distant thunder", "duration_seconds": 5 }

Sound effects: よくある質問

Sound effects の料金は?

$0.0026 per second. The Run button shows the exact price for your input before you start.

コードから呼び出すには?

API キーを付けて POST https://api.opennan.com/v1/audio/sound-effects を送ります。結果は同じレスポンスで返ります。

AI エージェントから使えますか?

はい。MCP サーバー https://api.opennan.com/v1/mcp を追加して generate_sfx ツールを呼び出すか、エージェントに https://api.opennan.com/llms.txt を読ませてください。

実行が失敗したら?

失敗した実行には料金がかかりません。支払いは結果に対してだけです。

Sound effects

入力

出力

仕組み

コードから Sound effects を呼び出す

API キーを取得

最初のリクエストを送る

結果を読む

エラーと直し方

AI アプリに Opennan を追加

AI エージェントから使う

Sound effects: よくある質問