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 必填
遮罩参数,必须包含 areas 或 url
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资源类型,例如
video、imageurl
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 | 服务不可用 |