AgentEarth
登录

Ae · Ace · Step

10.00积分/次
ae_ace_step

根据流派和风格标签创作音乐曲目，可选提供歌词和用于人声的歌曲段落。

音频娱乐
10.00积分/次

价格说明

10.00积分/次

API 调用

通过统一工具网关发起同步请求，鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://api.agentearth.ai/v1/tools/run' \
  --header 'Authorization: Bearer $AGENTEARTH_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "tool": "ae_ace_step",
  "input": {
    "seed": "xxx",
    "tags": "xxx",
    "lyrics": "xxx",
    "duration": "60",
    "scheduler": "euler",
    "guidance_type": "apg",
    "guidance_scale": "15",
    "number_of_steps": "27",
    "granularity_scale": "10",
    "guidance_interval": "0.5",
    "tag_guidance_scale": "5",
    "lyric_guidance_scale": "1.5",
    "minimum_guidance_scale": "3",
    "guidance_interval_decay": "0"
  }
}'
请求方式
POST
接口地址
/v1/tools/run
鉴权方式
Bearer Token
超时时间
60 秒
当前版本
—
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
seedinteger否Random seed for reproducibility. If not provided, a random seed will be used.—
tagsstring是Comma-separated list of genre tags to control the style of the generated audio.—
lyricsstring否Lyrics to be sung in the audio. If not provided or if [inst] or [instrumental] is the content of this field, no lyrics will be sung. Use control structures like [verse], [chorus] and [bridge] to control the structure of the song.—
durationnumber否The duration of the generated audio in seconds.60
schedulerenum (euler | heun)否Scheduler to use for the generation process.euler
guidance_typeenum (cfg | apg | cfg_star)否Type of CFG to use for the generation process.apg
guidance_scalenumber否Guidance scale for the generation.15
number_of_stepsinteger否Number of steps to generate the audio.27
granularity_scaleinteger否Granularity scale for the generation process. Higher values can reduce artifacts.10
guidance_intervalnumber否Guidance interval for the generation. 0.5 means only apply guidance in the middle steps (0.25 * infer_steps to 0.75 * infer_steps)0.5
tag_guidance_scalenumber否Tag guidance scale for the generation.5
lyric_guidance_scalenumber否Lyric guidance scale for the generation.1.5
minimum_guidance_scalenumber否Minimum guidance scale for the generation after the decay.3
guidance_interval_decaynumber否Guidance interval decay for the generation. Guidance scale will decay from guidance_scale to min_guidance_scale in the interval. 0.0 means no decay.0