文档 / 音乐系列 / Suno / 辅助功能
辅助功能GETSunopromptsuggestionssuno_prompts_suggestions
获取风格灵感建议
获取 Suno 上游的随机风格或灵感建议。
Bearer API KeyJSON服务端调用
用途#
获取 Suno 的随机风格 / 灵感建议，可用于在创作前为用户提供曲风、主题等提示。该接口为同步透传，无请求参数。
请求示例#
cURL
curl --request GET \
--url https://api.apimax.ai/v1/music/prompts/suggestions \
--header 'Authorization: Bearer <token>'无需请求体，仅需携带鉴权头。
响应#
该接口直接透传 Suno 上游返回的 JSON，不套用本服务的 code / message / data 包裹。响应结构以上游实际返回为准。
json
{
"prompts": [
"emotive bossa nova song about the silence after a fight",
"sad acoustic song about a revenge story",
"epic dancehall song about strangers on the same train"
],
"lyrics_prompts": [
"Time moves slow when you're waiting for a sign",
"Through the fire and the flood I'll find my way",
"We burned so bright we couldn't see the dark"
],
"tags": [
"russian rock",
"scandinavian folk",
"chipmunk soul",
"japanese female voice",
"ethereal female vocals"
],
"is_pending_personalization": false
}常见字段：prompts 为整段创作灵感建议，lyrics_prompts 为歌词灵感（可能含 [角色] 对话式片段），tags 为风格 / 音色标签建议，is_pending_personalization 表示个性化推荐是否仍在计算中。示例中各数组已截断,实际条数以上游返回为准。
透传接口的响应字段由上游决定，可能随上游版本变化；请以实际返回为准，不要对结构做强约束。
相关说明#
- 该接口仅返回灵感建议，不会创建任何任务，也不消耗生成配额。
- 如需把风格标签进一步润色扩写，请使用
POST /v1/music/prompts/upsample。