sound-effects

効果音

each::senseを使って、あらゆる用途に合わせたカスタム効果音を生成します。each::senseは、リクエストに最適なモデルを自動で選択するインテリジェントなAIエージェントです。

クイックスタート

each::labsのAPIキーが必要です。eachlabs.aiで取得してください。

curlを使用する場合

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: a heavy wooden door creaking open slowly in a stone castle hallway, with echo and reverb. 3 seconds long."}],
    "stream": false
  }'

Pythonを使用する場合（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_EACHLABS_API_KEY",
    base_url="https://eachsense-agent.core.eachlabs.run/v1"
)

response = client.chat.completions.create(
    model="eachsense/beta",
    messages=[{"role": "user", "content": "Generate a sound effect: a heavy wooden door creaking open slowly in a stone castle hallway, with echo and reverb. 3 seconds long."}]
)

print(response.choices[0].message.content)

参照画像を使用する場合

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": [
              {"type": "text", "text": "Generate realistic sound effects that match this scene. Create the ambient soundscape a viewer would hear if they were standing in this location."},
              {"type": "image_url", "image_url": {"url": "https://example.com/forest-scene.jpg"}}
            ]
          }
    ],
    "stream": false
  }'

画像は、OpenAIのマルチモーダルコンテンツ形式を使ってメッセージ内に送信されます。1回のリクエストで使用できる画像は最大4枚です。

ストリーミング

リアルタイムのSSEレスポンスを受け取るには"stream": trueを、1回のレスポンスで結果をすべて受け取るには"stream": falseを設定します。ストリーミングはUIで進行状況を表示するのに便利です。スクリプトや自動化では、非ストリーミングのほうが簡単です。

利用可能なモデル

モデル	強み	最適な用途
stable-audio-2-5	正確な音声生成、短尺コンテンツ、高品質	効果音、フォーリー、環境音、UIサウンド
mureka-generate-music	音楽的なサウンドデザイン、音程のある効果音	音楽的な短いジングル、ジングル、音程のあるトランジション

効果音のカテゴリ

カテゴリ	例	一般的な長さ
自然	雨、雷、風、鳥、海の波、燃えさかる炎	3～30秒
衝撃音	パンチ、衝突、爆発、強打、粉砕、ドスンという音	0.5～3秒
機械音	エンジンの始動、ギアチェンジ、油圧プレス、時計の刻む音	1～10秒
UI／デジタル	通知音、ボタンクリック、エラー音、レベルアップのチャイム	0.1～2秒
フォーリー	足音、布のこすれる音、紙を丸める音、液体を注ぐ音	1～5秒
トランジション	ヒューッという音、シュッという音、ライザー、逆再生シンバル、短い効果音	0.5～3秒
SF	レーザーの発射音、ワープドライブ、フォースフィールドのうなり、異星人の話し声	0.5～5秒
ホラー	床板のきしみ、ささやき、遠くから聞こえる悲鳴、心臓の鼓動	1～10秒
カートゥーン	ポヨンという音、ベチャッという音、スライドホイッスル、コミカルなクラクション	0.5～2秒
環境音	喫茶店のざわめき、オフィスのうなり、街の交通音、地下鉄	10～30秒

プロンプトのヒント

効果音プロンプトのフォーマット

Generate a sound effect: [what it is] + [material/texture] + [environment/space] + [duration]

音の特徴を表現する

特徴	キーワード
明るい	歯切れのよい、鋭い、金属的な、響き渡る、明瞭な
暗い	深い、ゴロゴロとうなる、低い、こもった、厚みのある
ウェット	リバーブ、エコー、広がりのある、洞窟のような、水中のような
ドライ	近接マイクで録った、タイトな、リバーブなし、親密な
歪んだ	オーバードライブのかかった、ざらついた、クリップした、飽和した
クリア	純粋な、混じりけのない、デジタルの、洗練された

長さのガイドライン

長さを具体的に指定します。

"0.5 seconds" — quick hits, clicks, notifications
"1-3 seconds" — impacts, transitions, short effects
"5-10 seconds" — ambient loops, longer foley
"15-30 seconds" — environment ambiences, atmospheric beds

レイヤー化の指示

1つの効果音に複数の要素を含めるようリクエストします。

"A thunderclap with: initial crack, rolling rumble that
fades over 5 seconds, light rain in the background throughout"

例

シネマティックな衝撃音

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: cinematic deep bass impact hit followed by a reverb tail that decays over 3 seconds. Like a movie trailer boom. Massive sub-bass presence, felt in the chest. Dry initial hit, then spacious reverb."}],
    "stream": false
  }'

UI通知音

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: a pleasant, subtle notification chime for a mobile app. Two ascending xylophone-like tones, bright and friendly. 0.5 seconds total. Clean and digital, not overly attention-grabbing. Think premium tech product."}],
    "stream": false
  }'

自然の環境音

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: a peaceful forest ambience at dawn. Gentle birdsong from multiple species at varying distances, a soft breeze rustling through leaves, a distant stream trickling over rocks. 20 seconds long. Naturalistic and immersive."}],
    "stream": false
  }'

SFのレーザー

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: a futuristic laser blaster firing three rapid shots. Each shot has a sharp zap with a synthesized sizzle tail. High-pitched, energetic, slightly different pitch for each shot. 1.5 seconds total. Sci-fi video game style."}],
    "stream": false
  }'

ホラーの雰囲気

curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "messages": [{"role": "user", "content": "Generate a sound effect: unsettling horror ambience for a haunted house scene. Low droning hum, occasional distant creaking wood, a faint whisper that passes from left to right, and a single slow heartbeat. 15 seconds. Dark, tense, and deeply unsettling."}],
    "stream": false
  }'

効果音の一括生成

# Generate a complete UI sound kit
EFFECTS=(
  "Generate a sound effect: app launch whoosh, 0.3 seconds, bright and modern"
  "Generate a sound effect: button tap click, soft and tactile, 0.1 seconds"
  "Generate a sound effect: success completion chime, three ascending notes, 0.8 seconds, cheerful"
  "Generate a sound effect: error notification, two low descending tones, 0.5 seconds, gentle warning"
  "Generate a sound effect: message received ping, single bright bell tone, 0.3 seconds, pleasant"
)

for EFFECT in "${EFFECTS[@]}"; do
  curl -X POST https://eachsense-agent.core.eachlabs.run/v1/chat/completions \
    -H "Content-Type: application/json" \
    -H "X-API-Key: $EACHLABS_API_KEY" \
    -d "{
      \"messages\": [{\"role\": \"user\", \"content\": \"$EFFECT\"}],
      \"stream\": false
    }"
  echo "---"
done

よくある落とし穴

• 長さを指定しないと、モデルが長さを推測するため、プロジェクトに合わないことがあります。必ず長さを指定してください。
• 曖昧すぎる指示（「かっこいい音」など）では、ありきたりな結果になります。物理的な特徴を詳しく説明してください。
• 特定の著作権保護対象の音を完全に再現できると期待するのは困難です。代わりに、音の特徴を説明してください。
• 環境を指定しないと、文脈のない音になります。リアルさを高めるために、リバーブ、部屋の広さ、距離を指定してください。
• 一度に要素を詰め込みすぎたリクエストでは、音が濁ることがあります。複雑な場面は、個々の効果音を組み合わせてレイヤー化してください。

関連スキル

• 音楽生成 — インストゥルメンタル音楽やバックグラウンドトラックを生成します
• 音声生成 — 効果音に重ねる音声を生成します
• 動画生成 — 音声を合わせた動画を作成します
• 楽曲生成 — 効果音を含む楽曲を制作します

ドキュメント

• each::senseの概要
• each::labs API