歌曲生成接口

开发中

正式环境（默认全球加速）

https://api.yoy-ai.com

POST

/eleven/audios

最后修改时间：2026-04-13 08:29:31

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "action": "generate",
    "duration": 35000,
    "model": "music_v1",
    "composition_plan": {
        "positive_global_styles": [
            "流行摇滚",
            "高能量",
            "男声独唱",
            "4/4 拍"
        ],
        "negative_global_styles": [
            "爵士",
            "慢速",
            "器乐独奏"
        ],
        "sections": [
            {
                "section_name": "主歌 1",
                "positive_local_styles": [
                    "清脆的吉他扫弦",
                    "节奏感强"
                ],
                "negative_local_styles": [
                    "重金属失真"
                ],
                "duration_ms": 15000,
                "lines": [
                    "清晨的阳光洒在窗台",
                    "我推开门走向那片大海",
                    "风在耳边轻轻地诉说"
                ]
            },
            {
                "section_name": "副歌",
                "positive_local_styles": [
                    "强力的鼓点",
                    "激昂的合成器",
                    "情感爆发"
                ],
                "negative_local_styles": [
                    "安静的钢琴"
                ],
                "duration_ms": 20000,
                "lines": [
                    "奔跑吧 追逐那道光芒",
                    "心跳声 响彻整个天堂",
                    "不再回头 勇敢去闯"
                ]
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.yoy-ai.com/eleven/audios' \
--header 'Authorization: Bearer asdasdasda9998fads' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "generate",
    "duration": 35000,
    "model": "music_v1",
    "composition_plan": {
        "positive_global_styles": [
            "流行摇滚",
            "高能量",
            "男声独唱",
            "4/4 拍"
        ],
        "negative_global_styles": [
            "爵士",
            "慢速",
            "器乐独奏"
        ],
        "sections": [
            {
                "section_name": "主歌 1",
                "positive_local_styles": [
                    "清脆的吉他扫弦",
                    "节奏感强"
                ],
                "negative_local_styles": [
                    "重金属失真"
                ],
                "duration_ms": 15000,
                "lines": [
                    "清晨的阳光洒在窗台",
                    "我推开门走向那片大海",
                    "风在耳边轻轻地诉说"
                ]
            },
            {
                "section_name": "副歌",
                "positive_local_styles": [
                    "强力的鼓点",
                    "激昂的合成器",
                    "情感爆发"
                ],
                "negative_local_styles": [
                    "安静的钢琴"
                ],
                "duration_ms": 20000,
                "lines": [
                    "奔跑吧 追逐那道光芒",
                    "心跳声 响彻整个天堂",
                    "不再回头 勇敢去闯"
                ]
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "success": true,
    "task_id": "dd1c96df-37eb-4fe1-b546-2cfb390126f5",
    "trace_id": "c654400f-7cd1-4866-8f56-fcb2472480d9",
    "data": [
        {
            "id": "0537a80f-c004-4f6e-81ef-bd58ff763ba4",
            "size": 560946,
            "duration": 35059,
            "audio_url": "https://cdn.sunohub.cn/suno/dd1c96df-37eb-4fe1-b546-2cfb390126f5.mp3",
            "created_at": "2026-04-13T08:32:15.476Z",
            "finished_at": "2026-04-13T08:32:25.514Z",
            "model": "music_v1",
            "state": "succeeded",
            "metadata": {
                "song_metadata": {
                    "title": null,
                    "genres": [],
                    "languages": [],
                    "description": null,
                    "is_explicit": null
                },
                "composition_plan": {
                    "sections": [
                        {
                            "lines": [
                                "清晨的阳光洒在窗台",
                                "我推开门走向那片大海",
                                "风在耳边轻轻地诉说"
                            ],
                            "duration_ms": 15000,
                            "section_name": "主歌 1",
                            "negative_local_styles": [
                                "重金属失真"
                            ],
                            "positive_local_styles": [
                                "清脆的吉他扫弦",
                                "节奏感强"
                            ]
                        },
                        {
                            "lines": [
                                "奔跑吧 追逐那道光芒",
                                "心跳声 响彻整个天堂",
                                "不再回头 勇敢去闯"
                            ],
                            "duration_ms": 20000,
                            "section_name": "副歌",
                            "negative_local_styles": [
                                "安静的钢琴"
                            ],
                            "positive_local_styles": [
                                "强力的鼓点",
                                "激昂的合成器",
                                "情感爆发"
                            ]
                        }
                    ],
                    "negative_global_styles": [
                        "爵士",
                        "慢速",
                        "器乐独奏"
                    ],
                    "positive_global_styles": [
                        "流行摇滚",
                        "高能量",
                        "男声独唱",
                        "4/4 拍"
                    ]
                },
                "words_timestamps": null
            }
        }
    ]
}

修改于 2026-04-13 08:29:31

角色创建接口

歌曲任务查询接口