Midjourney接入向导
Midjourney接入向导
模式接入点
或通过令牌设置 设置模式、返回图片代理方式
API接口类型
类型1:新任务创建
/mj/submit/imagine
/mj/submit/blend
/mj/submit/describe
/mj/submit/shorten
类型2:任务再操作
/mj/submit/action
/mj/submit/modal
类型3:任务查询
/mj/task/{id}/fetch
接入流程 Demo
第一步: 提交类型1 Imagine 任务
curl --request post \
--url {{BASE_URL}}/fast/mj/submit/imagine \
--header 'Authorization: Bearer sk-替换为你的key' \
-H "Content-Type: application/json" \
--data '{
"base64Array": [],
"prompt": "black cat"
}'
第二步: 根据任务ID获取任务结果
1320098173412546
,得到返回结果。curl --request GET \
--url {{BASE_URL}}/fast/mj/task/1320098173412546/fetch \
--header 'Authorization: Bearer sk-替换为你的key' \
-H "Content-Type: application/json"
{
"id": "1320098173412546",
"action": "IMAGINE",
"prompt": "cat --v 6.1",
"promptEn": "cat --v 6.1",
"description": "Submit success",
"state": "",
"submitTime": 1741531578038,
"startTime": 1741531580190,
"finishTime": 1741531608566,
"imageUrl": "https://img.innk.cc/attachments/1320066655572987907/1348306030429470862/adam_rivera4952_cat_26d56b92-4ed6-45e2-8561-563797923135.png?ex=67cefb57\u0026is=67cda9d7\u0026hm=b87e6b24e4bc3c2f1584b72154075607d6115602d0e5c7777e6637c29b8d3bd5\u0026",
"status": "SUCCESS",
"progress": "100%",
"failReason": "",
"properties": {
"botType": "MID_JOURNEY",
"discordChannelId": 8774786694361674000,
"discordInstanceId": 7415633538733103000,
"finalPrompt": "cat --v 6.1 --sref \u003chttps://s.mj.run/ktqQpnwPoPk\u003e",
"flags": 0,
"messageContent": "**cat --v 6.1 --sref \u003chttps://s.mj.run/ktqQpnwPoPk\u003e** - \u003c@1343445981269594182\u003e (relaxed)",
"messageHash": "26d56b92-4ed6-45e2-8561-563797923135",
"messageId": "1348306030706036789",
"nonce": "1619855216344100864",
"notifyHook": "",
"progressMessageId": "1348305922325479495"
},
"buttons": [
{
"customId": "MJ::JOB::upsample::1::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "U1",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::upsample::2::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "U2",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::upsample::3::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "U3",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::upsample::4::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "U4",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::reroll::0::26d56b92-4ed6-45e2-8561-563797923135::SOLO",
"emoji": "🔄",
"label": "",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::variation::1::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "V1",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::variation::2::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "V2",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::variation::3::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "V3",
"style": 2,
"type": 2
},
{
"customId": "MJ::JOB::variation::4::26d56b92-4ed6-45e2-8561-563797923135",
"emoji": "",
"label": "V4",
"style": 2,
"type": 2
}
]
}
第三步: 点击按钮,执行动作
{
"customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
"taskId": "14001934816969359"
}
第四步 根据任务ID获取任务结果
接口详细介绍
类型1:提交Imagine任务
/mj/submit/imagine
请求示例:
{
"base64Array": [],
"prompt": "Cat"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
imagineDTO | imagineDTO | body | true | Imagine提交参数 | Imagine提交参数 |
base64Array | 垫图base64数组 | false | array | string | |
prompt | 提示词 | true | string |
响应状态说明:
状态码 | 说明 | schema |
---|---|---|
200 | OK | 提交结果 |
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
}
提交Blend任务
/mj/submit/blend
请求示例:
{
"base64Array": [
"data:image/png;base64,xxx1",
"data:image/png;base64,xxx2"
],
"dimensions": "SQUARE"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
blendDTO | blendDTO | body | true | Blend提交参数 | Blend提交参数 |
base64Array | 图片base64数组 | true | array | string | |
dimensions | 比例: PORTRAIT(2:3); SQUARE(1:1); LANDSCAPE(3:2) | false | string |
响应示例:
{
"code": 1,
"description": "提交成功",
"properties": {},
"result": 1320098173412546
}
提交图生文任务
/mj/submit/describe
请求示例:
{
"base64": "data:image/png;base64,xxx"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
describeDTO | describeDTO | body | true | Describe提交参数 | Describe提交参数 |
base64 | 图片base64 | true | string |
响应示例:
{
"code": 1,
"description": "提交成功",
"properties": {},
"result": 1320098173412546
}
提交Shorten任务
/mj/submit/shorten
请求示例:
{
"prompt": "Cat"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
shortenDTO | shortenDTO | body | true | Shorten提交参数 | Shorten提交参数 |
prompt | 提示词 | true | string |
响应示例:
{
"code": 1,
"description": "提交成功",
"properties": {},
"result": 1320098173412546
}
类型2:执行动作
/mj/submit/action
请求示例:
{
"customId": "MJ::JOB::upsample::2::3dbbd469-36af-4a0f-8f02-df6c579e7011",
"taskId": "14001934816969359"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
actionDTO | actionDTO | body | true | 执行动作参数 | 执行动作参数 |
customId | 动作标识 | true | string | ||
taskId | 任务ID | true | string |
响应示例:
{
"code": 1,
"description": "提交成功",
"properties": {},
"result": 1320098173412546
}
提交Modal
/mj/submit/modal
请求示例:
{
"maskBase64": "",
"prompt": "",
"taskId": "14001934816969359"
}
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
modalDTO | modalDTO | body | true | Modal提交参数 | Modal提交参数 |
maskBase64 | 局部重绘的蒙版base64 | false | string | ||
prompt | 提示词 | false | string | ||
taskId | 任务ID | true | string |
响应示例:
{
"code": 1,
"description": "提交成功",
"properties": {},
"result": 1320098173412546
}
指定ID获取任务
/mj/task/{id}/fetch
请求示例:
curl --request GET \
--url {{BASE_URL}}/fast/mj/task/1320098173412546/fetch \
--header 'Authorization: Bearer sk-替换为你的key' \
-H "Content-Type: application/json"
请求参数说明:
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
id | 任务ID | path | true | string |
响应参数说明:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
action | 任务类型, 值: IMAGINE, UPSCALE, VARIATION, ZOOM, PAN, DESCRIBE, BLEND, SHORTEN | string | |
buttons | 可执行按钮,再操作的可选按钮 | array | |
customId | 动作标识 | string | |
emoji | 图标 | string | |
label | 文本 | string | |
style | 样式: 2(Primary)、3(Green) | integer(int32) | |
type | 类型,系统内部使用 | integer(int32) | |
description | 任务描述 | string | |
failReason | 失败原因 | string | |
finishTime | 结束时间 | integer(int64) | integer(int64) |
id | ID | string | |
imageUrl | 图片url | string | |
progress | 任务进度 | string | |
prompt | 提示词 | string | |
promptEn | 提示词-英文 | string | |
properties | 扩展字段 | object | |
startTime | 开始执行时间 | integer(int64) | integer(int64) |
state | 自定义参数 | string | |
status | 任务状态, 可用值: NOT_START, SUBMITTED, MODAL, IN_PROGRESS, FAILURE, SUCCESS | string | |
submitTime | 提交时间 | integer(int64) | integer(int64) |
响应示例:
{
"action": "",
"buttons": [
{
"customId": "",
"emoji": "",
"label": "",
"style": 0,
"type": 0
}
],
"description": "",
"failReason": "",
"finishTime": 0,
"id": "",
"imageUrl": "",
"progress": "",
"prompt": "",
"promptEn": "",
"properties": {},
"startTime": 0,
"state": "",
"status": "",
"submitTime": 0
}
修改于 2025-03-09 14:59:06