sound-effects

ElevenLabs 効果音

テキストの説明から効果音を生成します。ループ再生、任意の長さ、プロンプトへの追従度の調整に対応しています。

コードを書く前のセットアップ： このプロジェクトに ELEVENLABS_API_KEY が設定されていない場合は、まずアプリのフォルダーから npx -y @elevenlabs/cli@latest onboard init を実行し、表示される手順に従ってください。ユーザーのサインインとプロジェクト用キーの保存が行われるため、手動でキーをコピーする必要はありません。それ以外の場合は、インストールガイドを参照してください。JavaScript では、@elevenlabs/* パッケージのみを使用してください。

クイックスタート

Python

from elevenlabs import ElevenLabs

client = ElevenLabs()

audio = client.text_to_sound_effects.convert(
    text="Thunder rumbling in the distance with light rain",
)

with open("thunder.mp3", "wb") as f:
    for chunk in audio:
        f.write(chunk)

JavaScript

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
import { createWriteStream } from "fs";

const client = new ElevenLabsClient();
const audio = await client.textToSoundEffects.convert({
  text: "Thunder rumbling in the distance with light rain",
});
audio.pipe(createWriteStream("thunder.mp3"));

CLI

elevenlabs text-to-sound-effects convert \
  --text "Thunder rumbling in the distance with light rain" \
  --output thunder.mp3

パラメーター

パラメーター	型	デフォルト	説明
text	文字列（必須）	—	生成する効果音の説明
model_id	文字列	eleven_text_to_sound_v2	使用するモデル
duration_seconds	数値 | null	null（自動）	長さは0.5～30秒。nullの場合は自動計算
prompt_influence	数値 | null	0.3	プロンプトへの追従度（0～1）
loop	ブール値	false	シームレスにループするサウンドを生成します（v2モデルのみ）

パラメーターを指定した例

# Looping ambient sound, 10 seconds
audio = client.text_to_sound_effects.convert(
    text="Gentle forest ambiance with birds chirping",
    duration_seconds=10.0,
    prompt_influence=0.5,
    loop=True,
)

# Short UI sound, high prompt adherence
audio = client.text_to_sound_effects.convert(
    text="Soft notification chime",
    duration_seconds=1.0,
    prompt_influence=0.8,
)

出力形式

--output-format（CLI）を渡すか、SDK パラメーターとして output_format を指定します。

形式	説明
mp3_44100_128	MP3、44.1kHz、128kbps（デフォルト）
pcm_44100	CD品質の非圧縮生データ
opus_48000_128	Opus、48kHz、128kbps — 効率的な圧縮形式
ulaw_8000	μ-law、8kHz — 電話用

全形式：mp3_22050_32、mp3_24000_48、mp3_44100_32、mp3_44100_64、mp3_44100_96、mp3_44100_128、mp3_44100_192、pcm_8000、pcm_16000、pcm_22050、pcm_24000、pcm_32000、pcm_44100、pcm_48000、wav_8000、wav_16000、wav_22050、wav_24000、wav_32000、wav_44100、wav_48000、ulaw_8000、alaw_8000、opus_48000_32、opus_48000_64、opus_48000_96、opus_48000_128、opus_48000_192。

プロンプトのヒント

• 具体的に記述します：「トタン屋根に降る激しい雨」＞「雨」
• 要素を組み合わせます：「遠くの交通音を背景にした砂利道の足音」
• スタイルを指定します：「映画のようなブラーム、ホラー」または「8ビットのレトロなジャンプ音」
• 雰囲気や状況を記述します：「廃ビルの中を吹き抜ける不気味な風の音」

エラー処理

try:
    audio = client.text_to_sound_effects.convert(text="Explosion")
except Exception as e:
    print(f"API error: {e}")

よくあるエラー：

• 401：APIキーが無効です
• 422：パラメーターが無効です（長さの範囲、prompt_influence の範囲を確認してください）
• 429：レート制限を超えています

参考資料

• インストールガイド