提交Midjourney绘画任务

接口功能：

提交Midjourney绘画任务，任务成功提交后将会异步进行绘制处理;

注意事项：

生成通道，fast：快速生成，消耗80积分，relax：普速，需排队等待，消耗50积分，默认是relax

（测试阶段）并发限制1，即一个用户只能有一个正在运行中的Midjourney绘画任务;购买积分后按照套餐包含的并发计算；

更多返回错误代码请看首页的错误代码描述;

操作提示：

接口默认为v6模型，可以在描述词后面输入需要的模型，例如“蓝天白云 --v 5.2”

图片比例默认1:1，可在描述词后面加需要的尺寸比例，例如“蓝天白云 --ar 16:9”

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

prompt

string

提示词

可选

提示词，支持中英文，如果img字段为空则必填

imageUrl

string

MJ生图参考垫图

可选

base64图片或者图片url地址,用于图生图（如果是图片url请确保此url公网可以访问）

crefUrl

string

角色参考垫图

可选

用于参考图片中的角色，base64图片或者图片url地址,用于图生图（如果是图片url请确保此url公网可以访问）
注意，此选项会覆盖imageRefType设置

srefUrl

string

风格参考垫图

可选

用于参考图片的风格，base64图片或者图片url地址,用于图生图（如果是图片url请确保此url公网可以访问）
注意，此选项会覆盖imageRefType设置

imageRefType

array[string]

垫图参考类型

可选

支持同时设置多个垫图类型，不可以重复，仅在imageUrl字段传值的时候生效

枚举值:

normalsrefcref

type

string

生成通道

可选

生成通道，fast：快速生成，消耗80积分，relax：普速，需排队等待，消耗50积分，默认是relax

callback

string

结果回调地址

可选

请参考回调使用指南

示例值:

https://exmple.com/callback

nonce

string

请求回调标识

可选

任意字符串，具体请参考回调使用指南

<= 32 字符

示例

{
  "prompt": "girl",
  "imageUrl": "https://img.pconline.com.cn/images/upload/upc/tx/photoblog/1411/14/c3/40933640_1415980441910_mthumb.png",
  "imageRefType": [
    "cref",
    "sref"
  ],
  "type": "fast"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

可选

paintingSign

string

绘画任务id

必需

请注意，所有任务提交为异步方式，如果需要获取任务结果请通过此任务ID调用获取任务详情接口获取任务的进度或者结果

used

integer

消耗积分

必需

本次任务消耗的积分量

balance

integer

剩余可用积分

必需

提交任务后账号剩余可用积分量

code

integer

API统一响应码

必需

错误码请参考此文档

msg

string

错误消息

必需

如果本次接口请求错误，则会返回对应的错误描述

success

boolean

是否处理成功

必需

简易字段用于区分本次请求接口是否处理成功

示例

{
    "data": {
        "paintingSign": "74cda5279c6a4097980079fe87b486b9",
        "used": 4,
        "balance": 9996,
    },
    "code": 0,
    "subCode": 1000,
    "success": true,
    "msg" : "词条中涉及敏感词，请调整后再生成图片"
}

接口功能：#

注意事项：#

操作提示：#

请求参数

示例代码

返回响应

接口功能：

注意事项：

操作提示：