🎨 Midjourney 绘图操作 API 帮助文档

基于 Midjourney Proxy 的强大图像生成与处理接口

📋 目录

📝 简介

Midjourney 是一个强大的图像生成和处理模型,可以根据自然语言描述创建、编辑和修改图像。通过提供不同的接口,可以实现各种图像生成和处理任务。

🔄 处理流程

  1. 初始任务:Imagine(文本生成图片)、Blend(多图混合)、Describe(图片描述)、Swap Face(人脸替换)
  2. 图片处理:U1-U4(放大操作)、V1-V4(变体生成)、Pan(图片平移)、Zoom(图片缩放)
  3. 特殊流程:Action + Modal(需要弹窗确认的操作)、Action 直接执行(不需要弹窗的操作)
  4. 任务管理:获取任务详情、获取图片 Seed、上传至 Discord

💡 请求示例

提交 Imagine 任务

POST /mj/submit/imagine
curl --location --request POST 'https://你的newapi服务器地址/mj/submit/imagine' \
--header 'Authorization: Bearer $NEWAPI_API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "botType": "MID_JOURNEY",
  "prompt": "Cat",
  "base64Array": [],
  "accountFilter": {
    "channelId": "",
    "instanceId": "",
    "modes": [],
    "remark": "",
    "remix": true,
    "remixAutoConsidered": true
  },
  "notifyHook": "",
  "state": ""
}'

响应示例:

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

提交 Blend 任务

POST /mj/submit/blend
curl --location --request POST 'https://你的newapi服务器地址/mj/submit/blend' \
--header 'Authorization: Bearer $NEWAPI_API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "botType": "MID_JOURNEY",
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "dimensions": "SQUARE"
}'

查询任务状态

GET /mj/task/{id}/fetch
curl --location --request GET 'https://你的newapi服务器地址/mj/task/{id}/fetch' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $NEWAPI_API_KEY'

📮 API 端点

任务提交接口

任务查询接口

其他接口

📋 参数详解

鉴权方法

在请求头中包含以下内容进行 API 密钥认证:

Authorization: Bearer $NEWAPI_API_KEY

通用参数

botType

accountFilter

📥 响应格式

状态码说明

状态码 说明
1 提交成功
22 任务排队中
21 参数错误
23 系统错误
24 账号不可用
25 余额不足

任务状态

状态值 说明
NOT_START 未开始
SUBMITTED 已提交
IN_PROGRESS 进行中
SUCCESS 成功
FAILURE 失败

💡 最佳实践

Prompt 编写建议

  1. 使用清晰简洁的语言描述期望的图像内容
  2. 可以参考 Midjourney 支持的各种参数来控制图片风格
  3. 适当使用否定描述以排除不需要的元素
  4. 可以通过图片 URL 作为参考来指导生成

图片格式要求

  • 支持格式:JPEG/JPG, PNG, GIF (静态), WEBP
  • 文件大小:最大 4MB
  • 分辨率:建议 1024x1024 或更高
  • 宽高比:支持 1:1、2:3、3:2

性能优化建议

  • 使用标准 Base64 编码格式,包含正确的 MIME 类型前缀
  • 使用 webhook 接收任务完成通知
  • 合理设置重试策略
  • 建议使用异步处理方式