MidJourney 接口提示
MidJourney 接口分为直接生成和二次编辑两类. 直接生成是指只需要提供提示词等必须的参数, 可以直接生成图片. 二次编辑是指需要提供前一个任务 ID 和图片编号来执行图片生成. inpaint 为二次编辑类别
认证
authorization string 必填
所有 API 请求都需要通过 Bearer Token 进行认证
获取 API Key:
访问 API Key 管理页面 获取您的 API Key
使用方法:
添加到请求头:
Authorization: Bearer YOUR_API_KEY
参数
model string 必填
请求使用的模型 ID
可选值: midjourney_inpaint
jobId string 必填
任务 ID
imageNo integer 必填
图像编号,必须是 0、1、2 或 3
可选值: 0、1、2、3
mask object 必填
遮罩参数,必须包含 areas 或 url
areas
array遮罩区域对象数组
width
integer区域宽度
范围:
500-4096height
integer区域高度
范围:
500-4096points
array区域坐标点数组,至少包含 6 个坐标值(3 个点)
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
元数据信息
错误码
| 错误码 | 说明 |
|---|---|
| 004006001 | 任务 ID 缺失 |
| 004006002 | 图像编号缺失 |
| 004006003 | 图像编号无效 |
| 004006004 | 重混提示词长度无效 |
| 004006005 | 遮罩参数缺失 |
| 004006006 | 遮罩参数无效 |
| 004006007 | 回调 URL 无效 |
| 004006098 | 生成失败 |
| 004006099 | 服务不可用 |