パラメータ名 | タイプ | 説明 | 備考 |
---|---|---|---|
prompt | string | 音楽生成のプロンプト | 例: "pop, happy" |
lyrics | string | 歌詞の内容 | 多段式の歌詞フォーマットをサポートする |
lyrics_type | string | 歌詞タイプ | 選択可能な値:"user", "instrumental", "generate"。 説明: |
- user :ユーザーが提供した歌詞を使用して音楽を生成する際、prompt はタグのような役割を果たし、スタイルを指定します。 | |||
- instrumental :純音楽を作成するために、prompt は関連するキーワードとして使用されます。 | |||
- generate :歌詞を自動生成する際、prompt はどのような曲を生成するかを説明するために使用されます。 | |||
model_type | string | モデルタイプ | 選択可能な値:"udio32-v1.5", "udio130-v1.5"。 説明: |
- "udio130-v1.5":曲の長さは固定で130秒。 | |||
- "udio32-v1.5":曲の長さは固定で32秒。 | |||
config.mode | string | 設定モード | デフォルトは「regular」で、音楽を生成することを意味します。 |
negative_prompt | string | ネガティブプロンプトワード | 望ましくない特徴を指定するために使用します。 |
song_section_start | number | 曲のフラグメントの開始位置 | 範囲は0〜1で、デフォルトは0です。 説明: |
- 完全な曲の中でフラグメントを生成する開始位置を指定するために使用します。 | |||
song_section_end | number | 曲のフラグメントの終了位置 | 範囲は0〜1で、デフォルトは0です。 説明: |
- 完全な曲の中でフラグメントを生成する終了位置を指定するために使用します。 | |||
lyrics_placement_start | number | 歌詞の配置開始位置 | 範囲は0〜1。 |
lyrics_placement_end | number | 歌詞の配置終了位置 | 範囲は0〜1。 |
prompt_strength | number | プロンプトの強度 | 範囲は0〜1,デフォルトは 0.5 説明: |
- プロンプトが生成内容に与える影響の程度を制御します。値が高いほど、プロンプトへの遵循度が高まりますが、生成される音声が不自然になる可能性があります。 | |||
clarity_strength | number | クリア度の強度 | 範囲は0〜1,デフォルトは 0.25 説明: |
- モデルが音声を生成する際のクリア度と楽器の分離度の優先度を制御します。値が高いほど、よりクリアな音声が生成される可能性がありますが、音が不自然になることもあります。 | |||
lyrics_strength | number | 歌詞の強度 | 範囲は0〜1,デフォルトは0.5 説明: |
- 歌詞が生成される内容に与える影響の程度を制御します。値が低い場合、より自然な音声が生成される可能性がありますが、一部の歌詞の内容が無視されることもあります。 | |||
generation_quality | number | 生成品質 | 選択可能な値は 0.25、0.5、0.75、1 です。デフォルトは 0.75 で、数字が大きいほど品質が高くなりますが、速度は遅くなります。 |
seed | number | ランダムシード | デフォルトは-1、ランダムを意味します |
bypass_prompt_optimization | boolean | プロンプトの最適化をスキップしますか | デフォルトは false 。 |
{
"gen_params": {
"prompt": "a song about the moon",
"lyrics": "",
"lyrics_type": "generate",
"bypass_prompt_optimization": false,
"seed": -1,
"song_section_start": 0,
"prompt_strength": 0.5,
"clarity_strength": 0.25,
"lyrics_strength": 0.5,
"generation_quality": 0.75,
"negative_prompt": "",
"model_type": "udio32-v1.5",
"config": {
"mode": "regular"
}
}
}
curl --location --request POST 'https://api.302.ai/udio/generate-proxy' \
--header 'Authorization: Bearer sk-mfYQzy0XTFfz4P16vRE4gFrKK1Nly4TozsMqbbb9PSiJUvFO' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
"gen_params": {
"prompt": "a song about the moon",
"lyrics": "",
"lyrics_type": "generate",
"bypass_prompt_optimization": false,
"seed": -1,
"song_section_start": 0,
"prompt_strength": 0.5,
"clarity_strength": 0.25,
"lyrics_strength": 0.5,
"generation_quality": 0.75,
"negative_prompt": "",
"model_type": "udio32-v1.5",
"config": {
"mode": "regular"
}
}
}'
{
"code": "success",
"message": "",
"data": "69c61512-278e-4ff4-b6ea-f3b278329b04"
}