ElevenLabs Music Generation

テキストプロンプトから音楽を生成します。インストルメンタルトラック、歌詞付きの曲に対応し、composition plans による細かい制御も可能です。

セットアップ: インストールガイド を参照してください。JavaScript の場合は @elevenlabs/* パッケージのみを使用してください。

クイックスタート

Python

from elevenlabs import ElevenLabs

client = ElevenLabs()

audio = client.music.compose(
    prompt="A chill lo-fi hip hop beat with jazzy piano chords",
    music_length_ms=30000
)

with open("output.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.music.compose({
  prompt: "A chill lo-fi hip hop beat with jazzy piano chords",
  musicLengthMs: 30000,
});
audio.pipe(createWriteStream("output.mp3"));

cURL

curl -X POST "https://api.elevenlabs.io/v1/music" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "A chill lo-fi beat", "music_length_ms": 30000}' --output output.mp3

メソッド

メソッド	説明
music.compose	プロンプトまたは composition plan から音声を生成
music.composition_plan.create	細かい制御用の構造化されたプランを生成
music.compose_detailed	音声 + composition plan + メタデータを生成
music.video_to_music	アップロードされた1つ以上のビデオファイルから背景音楽を生成
music.upload	後続の inpainting ワークフロー用に音声ファイルをアップロードし、必要に応じて composition plan を抽出

全パラメータの詳細は API リファレンス を参照してください。

music.upload は inpainting 機能へのアクセス権を持つエンタープライズクライアントが利用できます。

ビデオから音楽へ

1つ以上のアップロードされたビデオクリップに従う背景音楽を生成します。API はビデオを順番に結合し、オプションで自然言語での説明を受け付け、upbeat や cinematic といった最大10個のタグでスタイルをコントロールできます。

Python

from elevenlabs import ElevenLabs

client = ElevenLabs()

audio = client.music.video_to_music(
    videos=["trailer.mp4"],
    description="Build suspense, then resolve with a warm cinematic finish.",
    tags=["cinematic", "suspenseful", "uplifting"],
)

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

cURL

curl -X POST "https://api.elevenlabs.io/v1/music/video-to-music" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -F "videos=@trailer.mp4" \
  -F "description=Build suspense, then resolve with a warm cinematic finish." \
  -F "tags=cinematic" \
  -F "tags=suspenseful" \
  -F "tags=uplifting" \
  --output video-score.mp3

現在の API スキーマからの制約:

• リクエストごとに1〜10個のビデオファイルをアップロード
• アップロードの合計サイズを200 MB 以下に保つ
• ビデオの合計継続時間を600秒以下に保つ
• 高水準の音楽的指示には description を、簡潔なスタイルのキューには tags を使用

Composition Plans

細かい制御のため、最初に composition plan を生成し、それを修正してから構成します:

plan = client.music.composition_plan.create(
    prompt="An epic orchestral piece building to a climax",
    music_length_ms=60000
)

# スタイルとセクションを検査/修正
print(plan.positiveGlobalStyles)  # 例: ["orchestral", "epic", "cinematic"]

audio = client.music.compose(
    composition_plan=plan,
    music_length_ms=60000
)

コンテンツ制限

• 特定のアーティスト、バンド、または著作権保護されている歌詞を参照することはできません
• bad_prompt エラーには代替フレーズを含む prompt_suggestion が含まれます
• bad_composition_plan エラーには composition_plan_suggestion が含まれます

エラーハンドリング

try:
    audio = client.music.compose(prompt="...", music_length_ms=30000)
except Exception as e:
    print(f"API error: {e}")

よくあるエラー: 401 (無効なキー)、422 (無効なパラメータ)、429 (レート制限)。

リファレンス

• インストールガイド
• API リファレンス