创建音乐 - MagicAPI

请求参数

Authorization

Body 参数application/json

gen_params

object

必需

lyrics

string

在自定义歌词时填写

可选

lyrics_type

string

必需

user 使用用户提供的歌词生成音乐，此时 prompt 的作用类似于 tags，填写风格
instrumental 用于创建纯音乐，prompt 用于相关提示词
generate 表示自动生成歌词，prompt 用于描述需要生成什么样的歌曲。

prompt

string

必需

bypass_prompt_optimization

boolean

必需

seed

integer

必需

song_section_start

number

必需

用于指定在完整歌曲中生成片段的起始和结束位置。0% (0) 对应歌曲开头，50% (0.5) 对应歌曲中间，100% (1) 对应歌曲结尾。点击数值指示器可切换为自动模式，让模型自行决定最佳位置。这个功能在使用歌曲扩展特性时特别有用。
歌曲片段开始位置范围 0-1, 默认 0

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，数字越大，质量越高，速度越慢。

model_type

string

必需

udio32-v1.5 (30s的歌曲) / udio130-v1.5 (130s的歌曲)

config

object

必需

示例

{
  "gen_params": {
    "prompt": "愉快的，摇滚的，学猫叫",
    "lyrics": "",
    "lyrics_type": "generate",
    "bypass_prompt_optimization": false,
    "seed": -1,
    "song_section_start": 0.4,
    "prompt_strength": 0.5,
    "clarity_strength": 0.25,
    "lyrics_strength": 0.5,
    "generation_quality": 0.75,
    "model_type": "udio130-v1.5",
    "config": {
      "mode": "regular"
    }
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST '{{BASE_URL}}/udio/submit/music' \
--header 'Content-Type: application/json' \
--data-raw '{
    "gen_params": {
        "prompt": "愉快的，摇滚的，学猫叫",
        "lyrics": "",
        "lyrics_type": "generate",
        "bypass_prompt_optimization": false,
        "seed": -1,
        "song_section_start": 0.4,
        "prompt_strength": 0.5,
        "clarity_strength": 0.25,
        "lyrics_strength": 0.5,
        "generation_quality": 0.75,
        "model_type": "udio130-v1.5",
        "config": {
            "mode": "regular"
        }
    }
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

string

必需

示例

{
  "code": "success",
  "message": "",
  "data": "1b171b81-31c0-41a0-85de-627abad34eb6"
}