Fun-Music モデル API リファレンス - Alibaba Cloud Model Studio

Fun-Music 音楽生成モデルの API パラメーターです。

ユーザーガイド：モデルの概要と選定ガイダンスについては、音楽生成をご参照ください。

重要このモデルは現在、限定プレビュー提供中です。使用する前に、モデルギャラリーからアクセス申請を行ってください。このモデルは中国 (北京) リージョンでのみ利用可能です。

前提条件

API キーが必要です。取得方法については、「Get an API key」をご参照ください。

エンドポイント

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation。 WorkspaceId を実際のワークスペース ID に置き換えてください。

プロトコル: HTTPS。ストリーミング出力では、X-DashScope-SSE リクエストヘッダーを設定して SSE (サーバーセントイベント) を有効にします。

重要Alibaba Cloud Model Studio は、中国 (北京) およびシンガポールの各リージョン向けにワークスペース固有ドメインをリリースしました。これらの新しい専用ドメインにより、推論リクエストのパフォーマンスと安定性が向上します。以下の新しいドメインへの移行を推奨します：

中国 (北京)：https://dashscope.aliyuncs.com から https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com へ
シンガポール：https://dashscope-intl.aliyuncs.com から https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com へ

{WorkspaceId} はワークスペース ID です。Alibaba Cloud Model Studio コンソールの ワークスペースの詳細 ページで確認できます。既存のドメインは引き続き問題なく利用できます。

リクエストヘッダー

パラメーター	タイプ	必須	説明
Authorization	string	はい	`Bearer {api-key}`。 `{api-key}` をお使いの API キーに置き換えてください。
Content-Type	string	はい	`application/json`
X-DashScope-SSE	string	いいえ	SSE ストリーミング出力を有効にするには、`enable` に設定します。

リクエストボディ

modelstring（必須）

モデル名。有効な値：

fun-music-v1
fun-music-preview

入力オブジェクト(必須)

入力パラメーター。

プロパティ

prompt文字列(条件付きで必須)

テキストプロンプト。モデルはこのプロンプトに基づいて自動的に作曲し、音楽を生成します。

fun-music-v1：lyrics または prompt のいずれかを指定する必要があります。
fun-music-preview：必須。

文字数制限：

非ストリーミング：1～2,000 文字
ストリーミング：中国語は 5～1,000 文字、英語は 5～1,000 語

注記prompt と lyrics の両方が指定された場合、lyrics のみが有効になり、prompt は無視されます。

lyrics文字列(条件付きで必須)

生成する楽曲の歌詞。

fun-music-v1: prompt または lyrics のいずれかを指定する必要があります。
fun-music-preview: 任意。

文字数制限：

非ストリーミング：中国語は 5～350 文字、英語は 5～2,000 文字
ストリーミング：中国語は 300～350 文字、英語は 200～250 語

注記lyrics と prompt の両方が指定された場合、lyrics のみが有効になり、prompt は無視されます。

gender文字列(任意) デフォルト: female

ボーカルの性別。fun-music-v1 モデルでのみサポートされています。有効な値:

male: 男性の声
female：女性音声

format文字列(任意) デフォルト: mp3

音声エンコード形式。有効な値：

mp3: ネットワーク転送および保存に適しています
wav: 後処理と高品質な再生に適しています

enable_aigc_watermarkブール値(任意) デフォルト: false

AIGC ウォーターマークを有効にするかどうかを指定します。有効にすると、生成された音声の末尾に "AI" (·— ··) を表すモールス信号の音声信号が付加され、AI 生成コンテンツであることを識別できます。ウォーターマークを有効にすると、音声の長さが増加します。

非ストリーミング

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "Fresh summer folk song, acoustic guitar and harmonica accompaniment, upbeat tempo, suitable as background music for travel vlogs",
        "gender": "female"
    }
}'

ストリーミング

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-DashScope-SSE: enable" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "High-energy electronic dance music, synthesizer effects, full of energy, suitable for workout scenes",
        "gender": "male"
    }
}'

レスポンスオブジェクト

request_id 文字列

リクエスト ID。トラブルシューティングおよびログトレースに使用します。

出力オブジェクト

モデルの出力。

プロパティ

audio オブジェクト

モデルによって出力された音声。

プロパティ

データ 文字列

ストリーミングモードでは Base64 エンコードされた音声チャンク。非ストリーミングモードでは空文字列。

url 文字列

完全な音声ファイルの OSS URL。有効期限は 24 時間です。すべての非ストリーミングレスポンスと、ストリーミングの最終メッセージにのみ含まれます。

id 文字列

音声ファイル ID。

expires_at 整数

音声 URL の有効期限を示す UNIX タイムスタンプ。

extra_info オブジェクト

生成された音声に関する追加のメタデータ。

プロパティ

チャネル 整数

音声チャネル数。たとえば、2 はステレオを示します。

sample_rate 文字列

音声サンプルレート。例: "48000"。

歌詞 文字列

生成された楽曲の歌詞。

finish_reason 文字列

生成ステータス：

null: 生成中
stop：生成が完了しました

使用法 object

このリクエストの請求情報。

プロパティ

duration 整数

請求に使用される、秒単位の楽曲の長さ。

非ストリーミング

{
    "output": {
        "audio": {
            "data": "",
            "expires_at": 1774936147,
            "id": "audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "extra_info": {
            "channels": 2,
            "lyrics": "[verse]\nMorning sunlight slips through the curtain,\nCoffee aroma fills up the room.\nOpen the book left unfinished yesterday,\nTime quietly drifts by this way.\n\n[chorus]\nTake it slow, there's no hurry,\nLife should be this carefree.\nToss your worries into the wind,\nEmbrace every sunny day and rainy season.",
            "sample_rate": "48000"
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "46c51288-7ed6-95cc-a119-xxxxxxxxxxxx"
}

ストリーミング (中間メッセージ)

{
    "output": {
        "audio": {
            "data": "Base64-encoded audio data",
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
        },
        "finish_reason": "null"
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}

ストリーミング (最終メッセージ)

{
    "output": {
        "audio": {
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx",
            "data": "",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "extra_info": {
            "channels": 2,
            "sample_rate": "48000",
            "lyrics": "[verse]\nMorning sunlight slips through the curtain,\nCoffee aroma fills up the room.\nOpen the book left unfinished yesterday,\nTime quietly drifts by this way.\n\n[chorus]\nTake it slow, there's no hurry,\nLife should be this carefree.\nToss your worries into the wind,\nEmbrace every sunny day and rainy season."
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}