サウンドエフェクトクイックスタート

このガイドでは、Sound Effects APIを使ってサウンドエフェクトを生成する方法を紹介します。

ElevenLabs sound-effectsスキルを使うと、AIコーディングアシスタントからサウンドエフェクトを生成できます。

npx skills add elevenlabs/skills --skill sound-effects

Sound Effects APIを使う

APIキーを作成する

APIに安全にアクセスするために使用するAPIキーは、ダッシュボードで作成できます。

キーは管理されたシークレットとして保存し、好みに応じて .env ファイルを通じた環境変数として、またはアプリの設定で直接SDKに渡してください。

.env

ELEVENLABS_API_KEY=<your_api_key_here>

SDKをインストールする

SDK

CLI

dotenvライブラリも使用して、環境変数からAPIキーを読み込みます。

pip install elevenlabs
pip install python-dotenv

スピーカーからオーディオを再生するには、MPVや ffmpegのインストールを求められる場合があります。

APIリクエストを送信する

SDK

CLI

使用する言語に応じてexample.pyまたはexample.mtsという新しいファイルを作成し、次のコードを追加します。

# example.py
import os
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
load_dotenv()
elevenlabs = ElevenLabs(
  api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_sound_effects.convert(text="Cinematic Braam, Horror")
play(audio)

次に実行します。

python example.py

生成したサウンドエフェクトがスピーカーから再生されます。

次のステップ

サウンドエフェクトの概要

サウンドエフェクト生成、対応フォーマット、ユースケースについて学ぶ

テキスト読み上げ

テキスト読み上げAPIで、テキストから音声オーディオを生成する

APIリファレンス

Sound Effectsのすべてのパラメータとレスポンス形式を確認する