图片与视频任务

POST /v1/tasks/kie

创建异步媒体任务

按配置的插件模型创建异步媒体任务(例如 KIE Suno 音乐模型 ai-music-api/generate,单次提交正常生成两条 MP3 音轨)。提交阶段经过登记屏障确认后进入轮询,超时或断线后请先查询原任务与诊断,切勿自动重发。

POST/v1/tasks/kie

身份验证

Authorizationstring必填

使用 OneAster 推理 API Key(Bearer sk-…)。

Authorization: Bearer $ONEASTER_API_KEY

请求正文 · application/json

modelstring必填

公开模型调用 ID;KIE Suno 异步音乐为 ai-music-api/generate(不能使用 display_name)

promptstring

提示词(上限 3000 字符)

ninteger

仅允许省略或 1;不通过 n 重复创建付费任务

audioobject
JSON 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
}