按配置的插件模型创建异步媒体任务(例如 KIE Suno 音乐模型 ai-music-api/generate,单次提交正常生成两条 MP3 音轨)。提交阶段经过登记屏障确认后进入轮询,超时或断线后请先查询原任务与诊断,切勿自动重发。
POST
/v1/tasks/kieAuthorizations
AuthorizationstringrequiredUse a OneAster inference API Key (Bearer sk-…).
Authorization: Bearer $ONEASTER_API_KEY
Body · application/json
modelstringrequired公开模型调用 ID;KIE Suno 异步音乐为 ai-music-api/generate(不能使用 display_name)
promptstring提示词(上限 3000 字符)
ninteger仅允许省略或 1;不通过 n 重复创建付费任务
audioobjectJSON Schema
{
"type": "object",
"required": [
"model"
],
"properties": {
"model": {
"type": "string",
"description": "公开模型调用 ID;KIE Suno 异步音乐为 ai-music-api/generate(不能使用 display_name)"
},
"prompt": {
"type": "string",
"maxLength": 3000,
"description": "提示词(上限 3000 字符)"
},
"n": {
"type": "integer",
"enum": [
1
],
"description": "仅允许省略或 1;不通过 n 重复创建付费任务"
},
"audio": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"music"
],
"description": "KIE Suno 音乐模式固定为 music"
},
"music_version": {
"type": "string",
"enum": [
"V6",
"V6_MINI",
"V6_WILD"
],
"default": "V6"
},
"custom_mode": {
"type": "boolean",
"default": false
},
"instrumental": {
"type": "boolean",
"default": false
},
"style": {
"type": "string",
"maxLength": 1000,
"description": "音乐风格(上限 1000 字符;style 与 lyrics 至少一项非空)"
},
"lyrics": {
"type": "string",
"maxLength": 5000,
"description": "歌词内容(上限 5000 字符;style 与 lyrics 至少一项非空)"
},
"title": {
"type": "string",
"maxLength": 80,
"description": "曲目标题(上限 80 字符;custom_mode=true 时必填)"
},
"duration": {
"type": "integer",
"anyOf": [
{
"const": 0
},
{
"type": "integer",
"minimum": 10,
"maximum": 360
}
],
"description": "目标时长秒(整数 10–360,仅 custom_mode=true 有效;省略或 0 不指定目标时长)"
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}