API 文档接口参考
Suno V6 · 查询单个模型
模型对象包含 slug、name、type、vendor、params 和 providers。供应商条目包含其实际参数和价格档位。
GET
/api/v1/models/{slug}公开接口 · 无需 API Key此模型使用的接口
POST
/generations创建生成任务GET/generations/{id}获取结果POST/generations/{id}/cancel取消任务POST/quote报价GET/models/{slug}查询单个模型选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入,请将示例媒体地址替换为可访问的文件。
请求
cURL
curl 'https://01router.com/api/v1/models/suno-v6'输入参数
查询 / 路径参数slugstring · path必填模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。
可选值:"suno-v6"
响应示例
200 · application/json
{
"slug": "suno-v6",
"name": "Suno V6",
"type": "audio",
"vendor": "Suno",
"description": "Suno V6 music generation: full songs with vocals or instrumentals from a description, or your own lyrics and style in custom mode. Each request returns two tracks.",
"tags": [
"music",
"lyrics",
"text-to-music"
],
"coverUrl": "",
"params": [
{
"name": "prompt",
"type": "text",
"label": "Prompt / lyrics",
"description": "Song description (simple mode) or lyrics (custom mode)"
},
{
"name": "custom_mode",
"type": "boolean",
"label": "Custom mode",
"description": "Use your own lyrics, style and title",
"default": false
},
{
"name": "instrumental",
"type": "boolean",
"label": "Instrumental",
"default": false
},
{
"name": "style",
"type": "string",
"label": "Style",
"description": "Custom mode only, e.g. \"dream pop, female vocals\""
},
{
"name": "title",
"type": "string",
"label": "Title",
"description": "Custom mode only"
},
{
"name": "negative_tags",
"type": "string",
"label": "Exclude styles"
},
{
"name": "vocal_gender",
"type": "enum",
"label": "Vocal gender",
"options": [
"m",
"f"
]
},
{
"name": "duration",
"type": "integer",
"label": "Duration (s)",
"description": "Custom mode only",
"min": 10,
"max": 360
}
],
"providers": [
{
"provider": "kie",
"providerName": "KIE AI",
"discount": 90,
"preferred": false,
"params": [
{
"name": "prompt",
"type": "text",
"label": "Prompt / lyrics",
"description": "Song description (simple mode) or lyrics (custom mode)",
"maxLength": 5000
},
{
"name": "custom_mode",
"type": "boolean",
"label": "Custom mode",
"description": "Use your own lyrics, style and title",
"default": false
},
{
"name": "instrumental",
"type": "boolean",
"label": "Instrumental",
"default": false
},
{
"name": "style",
"type": "string",
"label": "Style",
"description": "Custom mode only, e.g. \"dream pop, female vocals\"",
"maxLength": 1000
},
{
"name": "title",
"type": "string",
"label": "Title",
"description": "Custom mode only",
"maxLength": 80
},
{
"name": "negative_tags",
"type": "string",
"label": "Exclude styles"
},
{
"name": "vocal_gender",
"type": "enum",
"label": "Vocal gender",
"options": [
"m",
"f"
]
},
{
"name": "duration",
"type": "integer",
"label": "Duration (s)",
"description": "Custom mode only",
"min": 10,
"max": 360
}
],
"prices": [
{
"unit": "request",
"conditions": {},
"priceMicros": 54000,
"originalMicros": 60000,
"credits": 6
}
]
},
{
"provider": "apimart",
"providerName": "APIMart",
"discount": 90,
"preferred": false,
"params": [
{
"name": "prompt",
"type": "text",
"label": "Prompt / lyrics",
"description": "Song description (simple mode) or lyrics (custom mode)",
"maxLength": 5000
},
{
"name": "custom_mode",
"type": "boolean",
"label": "Custom mode",
"description": "Use your own lyrics, style and title",
"default": false
},
{
"name": "instrumental",
"type": "boolean",
"label": "Instrumental",
"default": false
},
{
"name": "style",
"type": "string",
"label": "Style",
"description": "Custom mode only, e.g. \"dream pop, female vocals\"",
"maxLength": 1000
},
{
"name": "title",
"type": "string",
"label": "Title",
"description": "Custom mode only",
"maxLength": 80
},
{
"name": "negative_tags",
"type": "string",
"label": "Exclude styles"
},
{
"name": "vocal_gender",
"type": "enum",
"label": "Vocal gender",
"options": [
"m",
"f"
]
},
{
"name": "duration",
"type": "integer",
"label": "Duration (s)",
"description": "Custom mode only",
"min": 10,
"max": 360
}
],
"prices": [
{
"unit": "request",
"conditions": {},
"priceMicros": 45000,
"originalMicros": 50000,
"credits": 5
}
]
},
{
"provider": "evolink",
"providerName": "EvoLink",
"discount": 90,
"preferred": false,
"params": [
{
"name": "prompt",
"type": "text",
"label": "Prompt / lyrics",
"description": "Song description (simple mode) or lyrics (custom mode)"
},
{
"name": "custom_mode",
"type": "boolean",
"label": "Custom mode",
"description": "Use your own lyrics, style and title",
"default": false
},
{
"name": "instrumental",
"type": "boolean",
"label": "Instrumental",
"default": false
},
{
"name": "style",
"type": "string",
"label": "Style",
"description": "Custom mode only, e.g. \"dream pop, female vocals\""
},
{
"name": "title",
"type": "string",
"label": "Title",
"description": "Custom mode only"
},
{
"name": "negative_tags",
"type": "string",
"label": "Exclude styles"
},
{
"name": "vocal_gender",
"type": "enum",
"label": "Vocal gender",
"options": [
"m",
"f"
]
},
{
"name": "duration",
"type": "integer",
"label": "Duration (s)",
"description": "Custom mode only",
"min": 10,
"max": 360
}
],
"prices": [
{
"unit": "request",
"conditions": {},
"priceMicros": 106200,
"originalMicros": 118000,
"credits": 11
}
]
},
{
"provider": "atlascloud",
"providerName": "AtlasCloud",
"discount": 90,
"preferred": false,
"params": [
{
"name": "prompt",
"type": "text",
"label": "Prompt / lyrics",
"description": "Song description (simple mode) or lyrics (custom mode)",
"maxLength": 3000
},
{
"name": "custom_mode",
"type": "boolean",
"label": "Custom mode",
"description": "Use your own lyrics, style and title",
"default": false
},
{
"name": "instrumental",
"type": "boolean",
"label": "Instrumental",
"default": false
},
{
"name": "style",
"type": "string",
"label": "Style",
"description": "Custom mode only, e.g. \"dream pop, female vocals\"",
"maxLength": 500
},
{
"name": "title",
"type": "string",
"label": "Title",
"description": "Custom mode only",
"maxLength": 200
},
{
"name": "negative_tags",
"type": "string",
"label": "Exclude styles",
"maxLength": 500
},
{
"name": "vocal_gender",
"type": "enum",
"label": "Vocal gender",
"options": [
"m",
"f"
]
},
{
"name": "duration",
"type": "integer",
"label": "Duration (s)",
"description": "Custom mode only",
"min": 10,
"max": 360
}
],
"prices": [
{
"unit": "request",
"conditions": {},
"priceMicros": 118800,
"originalMicros": 132000,
"credits": 12
}
]
}
],
"fromMicros": 45000,
"fromOriginalMicros": 50000,
"fromUnit": "request"
}响应仅用于说明结构;ID、用量、价格和结果以实际请求为准。
输出字段
slugstring模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。
paramsarray参数定义:name、type、required、default、options,以及已配置的 min、max、maxItems、maxLength。
providersarray可用供应商、各自的参数约束及公开价格档位。
给 AI 使用
把文档索引或完整接口文档交给 AI 编程助手,包含实时模型参数。