一、API 接口

1、提交Imagine（绘图）任务

接口地址：{代理地址}/mj/submit/imagine

请求方式：POST

请求数据类型：application/json

响应数据类型：*/*

请求示例:

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	是否必须	数据类型	schema
base64Array	垫图base64数组	false	array	string
prompt	提示词	true	string
state	自定义参数	false	string

响应状态:

状态码	说明	schema
200	OK
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 21(已存在), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

{
	"code": 1,
	"description": "提交成功",
	"result": "1705514776143750",
	"properties": {
		"discordInstanceId": "1146852997121441885"
	}
}

2、绘图变化

接口地址：{代理地址}/mj/submit/change

请求方式：POST

请求数据类型：application/json

响应数据类型：*/*

请求示例:

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	是否必须	数据类型
action	UPSCALE(放大); VARIATION(变换); REROLL(重新生成),可用值,VARIATION,REROLL	true	string
index	序号(1~4), action为UPSCALE,VARIATION时必传	false	integer(int32)
notifyHook	回调地址, 为空时使用全局notifyHook	false	string
state	自定义参数	false	string
taskId	任务ID	true	string

响应状态:

状态码	说明	schema
200	OK
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 21(已存在), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

3、指定ID获取任务

接口地址：{代理地址}/mj/task/{id}/fetch

请求方式：GET

请求数据类型：application/x-www-form-urlencoded

响应数据类型：*/*

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
id	任务ID	path	false	string

响应状态:

状态码	说明	schema
200	OK
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
action	可用值,UPSCALE,VARIATION,REROLL,DESCRIBE,BLEND	string
description	任务描述	string
failReason	失败原因	string
finishTime	结束时间	integer(int64)	integer(int64)
id	任务ID	string
imageUrl	图片url	string
progress	任务进度	string
prompt	提示词	string
promptEn	提示词-英文	string
startTime	开始执行时间	integer(int64)	integer(int64)
state	自定义参数	string
status	任务状态,可用值,SUBMITTED,IN_PROGRESS,FAILURE,SUCCESS	string
submitTime	提交时间	integer(int64)	integer(int64)

响应示例:

4、提交Describe任务

接口地址：{代理地址}/mj/sumbit/describe

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "botType": "MID_JOURNEY",
  "base64": "data:image/png;base64,xxx",
  "notifyHook": "",
  "state": ""
}

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
describeDTO	describeDTO	body	true	Describe提交参数	Describe提交参数
botType	bot类型，mj(默认)或niji,可用值:MID_JOURNEY,NIJI_JOURNEY		false	string
base64	图片base64		true	string
notifyHook	回调地址, 为空时使用全局notifyHook		false	string
state	自定义参数		false	string

响应状态:

状态码	说明	schema
200	OK	提交结果
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

{
	"code": 1,
	"description": "提交成功",
	"properties": {},
	"result": 1320098173412546
}

5、执行动作

接口地址: {代理地址}/mj/sumbit/action

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
  "taskId": "14001934816969359",
  "notifyHook": "",
  "state": ""
}

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	是否必须	数据类型
customId	动作标识	true	string
taskId	任务ID	true	string
notifyHook	回调地址, 为空时使用全局notifyHook	false	string
state	自定义参数	false	string

响应状态:

状态码	说明	schema
200	OK	提交结果
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

{
	"code": 1,
	"description": "提交成功",
	"properties": {},
	"result": 1320098173412546
}

6、提交Blend任务

接口地址: {代理地址}/mj/sumbit/blend

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "botType": "MID_JOURNEY",
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "dimensions": "SQUARE"
  "notifyHook": "",
  "state": ""
}

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	是否必须	数据类型	schema
botType	bot类型，mj(默认)或niji,可用值:MID_JOURNEY,NIJI_JOURNEY	false	string
base64Array	图片base64数组	true	array	string
dimensions	比例: PORTRAIT(2:3); SQUARE(1:1); LANDSCAPE(3:2),可用值:PORTRAIT,SQUARE,LANDSCAPE	false	string
notifyHook	回调地址, 为空时使用全局notifyHook	false	string
state	自定义参数	false	string

响应状态:

状态码	说明	schema
200	OK	提交结果
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

{
	"code": 1,
	"description": "提交成功",
	"properties": {},
	"result": 1320098173412546
}

7、提交Modal

接口地址: {代理地址}/mj/sumbit/modal

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

请求示例:

{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}

请求头: 二选一

key	value
Authorization	sk-xxxx
mj-api-secret	sk-xxxx

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	schema
modalDTO	modalDTO	body	true	Modal提交参数	Modal提交参数
maskBase64	局部重绘的蒙版base64		false	string
prompt	提示词		false	string
taskId	任务ID		true	string

响应状态:

状态码	说明	schema
200	OK	提交结果
201	Created
401	Unauthorized
403	Forbidden
404	Not Found

响应参数:

参数名称	参数说明	类型	schema
code	状态码: 1(提交成功), 22(排队中), other(错误)	integer(int32)	integer(int32)
description	描述	string
properties	扩展字段	object
result	任务ID	string

响应示例:

{
	"code": 1,
	"description": "提交成功",
	"properties": {},
	"result": 1320098173412546
}

二、部分功能使用示例

1、Modal使用示例(局部重绘)

执行Imagine任务，绘画初始作品

{代理地址}/mj/submit/imagine

根据id查询当前任务的结果

{代理地址}/mj/task/1710249468818538/fetch

获取V1按钮的customId，调用执行动作的接口，执行点击V1按钮的动作。此时会返回我们一个新的任务id，并告诉我们处于窗口等待状态。

{代理地址}/mj/submit/action

根据新的任务id查询结果，发现任务确实处于MODAL（窗口等待）状态

{代理地址}/mj/task/1710249468818538/fetch

执行modal接口，此时可以传入新的提示词用来修改细节，maskBase64只有局部重绘的时候需要传，此时可以删掉

{代理地址}/mj/submit/modal

再次查询该任务的结果，任务已经执行成功

{代理地址}/mj/task/1710249468818538/fetch

2、ZOOM (Upscale、Vary)示例

ZOOM

执行Imagine任务，绘画初始作品
{代理地址}/mj/submit/imagine

根据id查询当前任务的结果

获取U1按钮的customId，调用执行动作的接口，执行点击U1按钮的动作。此时会返回我们一个新的任务id
{代理地址}/mj/submit/action

根据新的任务id查询结果，可以看到该任务下面出现了局部重绘的按钮。
{代理地址}/mj/task/1710249468818538/fetch

获取Zoom customId 执行action

{代理地址}/mj/submit/action

6.查询任务，发现状态正常，ZOOM执行成功
{代理地址}/mj/task/1710249468818538/fetch

MidJourney使用介绍

#

一、API 接口#

1、提交Imagine（绘图）任务#

2、绘图变化#

3、指定ID获取任务#

4、提交Describe任务#

5、执行动作#

6、提交Blend任务#

7、提交Modal#

二、部分功能使用示例#

1、Modal使用示例(局部重绘)#

2、ZOOM (Upscale、Vary)示例#

ZOOM#

#

一、API 接口

1、提交Imagine（绘图）任务

2、绘图变化

3、指定ID获取任务

4、提交Describe任务

5、执行动作

6、提交Blend任务

7、提交Modal

二、部分功能使用示例

1、Modal使用示例(局部重绘)

2、ZOOM (Upscale、Vary)示例

ZOOM