MidJourney 接口提示
MidJourney 接口分为直接生成和二次编辑两类. 直接生成是指只需要提供提示词等必须的参数, 可以直接生成图片. 二次编辑是指需要提供前一个任务 ID 和图片编号来执行图片生成. edit 为二次编辑类别
认证
authorization string 必填
所有 API 请求都需要通过 Bearer Token 进行认证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
可选值: midjourney_edit
jobId string 必填
任务 ID
imageNo integer 必填
图片编号,必须是 0、1、2 或 3
可选值: 0、1、2、3
canvas object 必填
画布对象
width
integer必填像素宽
height
integer必填像素高
imgPos object 必填
图片相对画布的坐标及大小
width
integer必填像素宽
height
integer必填像素高
x
integer必填相对画布左上角水平位移
y
integer必填相对画布左上角垂直位移
remixPrompt string 必填
提示词,长度必须在 1-8192 字符之间
mask object
原图重绘区域
callback string
任务结果回调通知接口,必须是有效的 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
元数据信息
错误码
| 错误码 | 说明 |
|---|---|
| 004007001 | 缺少任务 ID |
| 004007002 | 缺少图像编号 |
| 004007003 | 无效图像编号 |
| 004007004 | 缺少重混提示词 |
| 004007005 | 重混提示词长度无效 |
| 004007006 | 缺少画布参数 |
| 004007007 | 缺少图像位置参数 |
| 004007008 | 回调 URL 无效 |
| 004007098 | 生成失败 |
| 004007099 | 服务不可用 |