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.
48 credits/call
Pricing
48 credits/call
| Condition | Charge |
|---|---|
| Each call | 48 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.prompt | string | Yes | The 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_url | string | null | No | No parameter description. | — |
request_body.negative_prompt | string | No | Lyria 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-KeySubmit 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
{
"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
AI Music Generation with AI AgentsHand an AI agent your lyrics or a one-line style description and let it call music-generation tools to produce a full song with vocals — then compare models and pick the best fit for short video, games, or marketing.What AI Agents Can Do With Tools: 15 Real Use CasesAn AI agent on its own can only talk. Connect it to tools and it can research, source products, generate images and video, pull live financial data, and more. Here are 15 real things agents do with tools.








