⌘K

MidJourney Uploadpaint

midjourney_uploadpaint

MidJourney Uploadpaint 允许上传自定义图像进行高级绘画和编辑操作

MidJourney 接口提示

MidJourney 接口分为直接生成二次编辑两类. 直接生成是指只需要提供提示词等必须的参数, 可以直接生成图片. 二次编辑是指需要提供前一个任务 ID 和图片编号来执行图片生成. uploadpaint 为直接生成类别

认证

authorization string 必填

所有 API 请求都需要通过 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用方法:

添加到请求头:

Authorization: Bearer YOUR_API_KEY

参数

model string 必填

请求使用的模型 ID

可选值: midjourney_uploadpaint


imgUrl string 必填

图像 URL,必须是有效的 HTTP/HTTPS URL,长度不超过 1024 字符


canvas object 必填

画布对象

width integer 必填

像素宽

height integer 必填

像素高


imgPos object 必填

图片相对画布的坐标及大小

x integer 必填

相对画布左上角水平位移

y integer 必填

相对画布左上角垂直位移

width integer 必填

像素宽

height integer 必填

像素高


mask object 必填

遮罩参数,必须包含 areasurl

areas array

遮罩区域对象数组

width integer

区域宽度

height integer

区域高度

points array

区域坐标点数组,至少包含 6 个坐标值

url string

遮罩图像 URL


remixPrompt string 必填

重混提示词,长度必须在 1-8192 字符之间


callback string

回调 URL,必须是有效的 HTTP/HTTPS URL


轮询

由于结果生成需要时间,您需要在创建任务后轮询任务状态

初始响应只返回任务 ID 和初始状态等信息,最终生成结果需通过使用该任务 ID 轮询任务状态接口获取

轮询请求与响应示例见右侧

响应格式

error object

错误信息,仅在状态为 failed 时出现

code integer

错误码

error_message string

详细错误信息


output array

生成结果,仅在状态为 completed 时出现

content array

生成的内容列表

type string

资源类型,例如 videoimage

url string

生成内容的 URL


usage object

使用统计信息,仅在状态为 completed 时出现

cost string

总费用(美元)

discount number

折扣金额


metadata object

元数据信息


错误码

错误码说明
004014001图像 URL 缺失
004014002图像 URL 长度无效
004014003图像 URL 格式无效
004014004画布参数缺失
004014005画布参数无效
004014006图像位置参数缺失
004014007图像位置参数无效
004014008遮罩参数缺失
004014009遮罩参数无效
004014010重混提示缺失
004014011重混提示长度无效
004014012回调 URL 无效
004014098生成失败
004014099服务不可用