Google Lyria3 Pro

96 credits/call
ae_lyria3_pro

Create an original song up to 3 minutes from a text description, with optional lyrics, vocals, and image-inspired mood. Returns an AE task ID; query status and results with ae_get_result. Lyria 3 does not support negative_prompt. Omit this parameter; only an empty string is retained for legacy compatibility. Do not send a non-empty negative_prompt.

Audio
96 credits/call

Pricing

96 credits/call
ConditionCharge
Each call96 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.promptstringYesThe text prompt describing the music you want to generate. Include genre, mood, instrumentation, tempo, and vocal style for best results. Lyria 3 supports vocals, lyrics, and multi-language generation.—
request_body.image_urlstring | nullNoNo parameter description.—
request_body.negative_promptstringNoLyria 3 不支持 negative_prompt。请省略该参数;仅为空字符串保留旧调用兼容,禁止传入非空值。 Lyria 3 does not support negative_prompt. Omit this parameter; only an empty string is retained for legacy compatibility. Do not send a non-empty negative_prompt.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_lyria3_pro' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "prompt": "Mandarin Chinese pop-rock duet ballad, epic ancient-Chinese gufeng atmosphere, cinematic and emotional, 78 BPM. TWO SINGERS alternating: a powerful masculine heroic male baritone (never soft or feminine) and a clear ethereal female soprano. The female sings her own solo verse and returns in the bridge and the a cappella outro; choruses are sung together in octave harmony. First half energetic with driving live drums and electric guitar riffs; second half turns atmospheric, spacious and dreamy with guzheng and strings. Sing these lyrics exactly:\n\n(男声)\n乱世风 卷长安尘痕\n布衣身 曾卧陋巷昏\n年少不问帝王尊\n只问谁 共我清贫\n旧柴门 霜雪刻年轮\n一柄剑 藏尽落魄身\n一纸婚书 抵过万户春\n唯初心 未染浮沉\n\n(男声)\n龙椅冷 不及枕边温\n江山阔 不及旧人真\n待到山河归我身\n此生一诺 不许折痕\n\n(合)\n故剑仍在 初心未改\n历尽风尘 不负旧年代\n万般荣华 皆为浮白\n我登帝位 只为你归来\n故情深埋 岁月未拆\n万丈皇权 换一句偏爱\n千秋史册 万章澎湃\n不及当年 陋巷春风在\n\n(女声独唱)\n我嫁你 布衣一诺深\n我陪你 陋巷度晨昏\n不求那 凤冠与金印\n只求你 记得这盏灯\n\n(男声)\n登金阶 满眼朱墙深\n掌乾坤 万众俯首臣\n一纸诏书 寻我故剑\n谁知宫墙 已藏杀心\n\n(男声)\n一剂苦药 换了晨昏\n孩儿尚幼 你已无声\n\n(合)\n故剑仍在 初心未改\n历尽风尘 不负旧年代\n万般荣华 皆为浮白\n我登帝位 只为你归来\n忍了五年 忍到不敢合眼\n霍氏满门 偿那一盏药的寒\n杀尽仇人 换不回你一眼\n\n(女声独唱,空灵)\n药烟散尽 我轻得像风\n南园的草 记得我的名\n南园梦 未曾冷\n故人情 未曾分\n从此山河归你 我归南园\n\n(女声,清唱留白)\n史笔千行 不写帝王\n只写 故剑情深一场\n南园春深 我不曾走远",
      "prompt_only": ""
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "625d2eb3-3dfc-4ba7-bff9-216526370996"
}

This example shows part of the response. Copied content is valid JSON.

Guides using this tool

See how this tool fits into real workflows