Google Lyria3

48 credits/call
ae_lyria3

Generate a 30-second music clip from a text prompt, optionally guided by an image. 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
48 credits/call

Pricing

48 credits/call
ConditionCharge
Each call48 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' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "prompt": "Serene ancient Chinese instrumental music for a game main menu, gentle guzheng plucked melody joined by soft bamboo flute (dizi), light pipa and warm strings, calm meditative elegant atmosphere, slow tempo, purely instrumental, no vocals, smooth gentle ending."
    }
  }
}'
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": "dae24c0b-170d-47cc-8d9e-a3eb5827bdbf"
}

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

Guides using this tool

See how this tool fits into real workflows