提交Imagine任务

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "method": "post",
  "path": "/mj/submit/imagine",
  "description": "提交 Midjourney/Niji 文生图任务。提交后通过任务查询或回调获取结果。",
  "parameters": {
    "header": [
      {
        "name": "Authorization",
        "type": "string",
        "required": true,
        "description": "Bearer API Key。所有 MJ 接口都必须携带；不要把真实 Key 写入前端、日志或代码仓库。",
        "sampleValue": "Bearer ${QINGYUN_TOP_API_KEY}"
      }
    ],
    "path": []
  },
  "requestBody": {
    "type": "application/json",
    "jsonSchema": {
      "type": "object",
      "properties": {
        "botType": {
          "type": "string",
          "description": "机器人类型：MID_JOURNEY（默认）或 NIJI_JOURNEY。",
          "example": "MID_JOURNEY"
        },
        "prompt": {
          "type": "string",
          "description": "提示词。",
          "example": "a cat in a red jacket"
        },
        "base64Array": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "垫图 Base64 数组。也可先上传图片获得链接后按当前服务能力使用。"
        },
        "notifyHook": {
          "type": "string",
          "description": "回调地址；为空时使用全局 notifyHook。"
        },
        "noStorage": {
          "type": "boolean",
          "description": "是否不保存/不返回平台存储链接；默认 false。具体链接策略以网关实际响应为准。",
          "example": "false"
        },
        "accountFilter": {
          "type": "object",
          "description": "账号筛选配置。"
        },
        "state": {
          "type": "string",
          "description": "自定义业务参数，回调或任务对象可能原样携带。"
        }
      },
      "required": [
        "prompt"
      ],
      "x-apifox-orders": [
        "botType",
        "prompt",
        "base64Array",
        "notifyHook",
        "noStorage",
        "accountFilter",
        "state"
      ]
    },
    "examples": [
      {
        "value": "{\n  \"botType\": \"MID_JOURNEY\",\n  \"prompt\": \"a cat in a red jacket\",\n  \"base64Array\": [],\n  \"notifyHook\": \"\",\n  \"noStorage\": false,\n  \"state\": \"demo-001\"\n}",
        "mediaType": "application/json",
        "description": "MJ 请求示例"
      }
    ]
  },
  "responses": [
    {
      "code": 200,
      "name": "成功或业务结果",
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "业务状态码。通常 1 表示提交成功，22 表示已进入排队；其他值表示提交失败。"
          },
          "description": {
            "type": "string",
            "description": "提交结果描述。"
          },
          "result": {
            "type": "string",
            "description": "任务 ID。提交成功后用它查询任务或执行后续 Action/Modal。"
          },
          "properties": {
            "type": "object",
            "description": "可选的服务端任务属性，例如 Discord 频道或实例信息。不要依赖未定义的子字段。"
          }
        },
        "x-apifox-orders": [
          "code",
          "description",
          "result",
          "properties"
        ]
      },
      "description": "HTTP 成功不等于任务成功；请继续检查响应体中的 code 或 status。"
    }
  ],
  "responseExamples": [
    {
      "name": "规范示例",
      "mediaType": "application/json",
      "data": "{\n  \"code\": 1,\n  \"description\": \"Submit success\",\n  \"result\": \"TASK_ID\",\n  \"properties\": {}\n}"
    }
  ]
}