🔥Midjourney API
Midjourney相关API,包含目前v5-v6所有操作。TTAPI 的 Midjourney API 是目前最稳定、最具成本效益的 Midjourney 产品。
速度模式
TT API 的 Midjourney 服务提供 relax、fast 和 turbo 三种模式的图像生成,与 Midjourney 对应。
fast 模式响应时间在 90秒内
relax 模式响应一般在 10分钟内
turbo 模式响应时间在 60秒内
最多可以 同时执行 10 个生成队列,如需更多作业队列请 联系我们
使用模式
TTAPI支持两种账户使用模式,满足不同用户、不同场景以及不同体量的使用需求。
PPU 模式(Pay for per use)按量付费,即使用TTAPI账户池中账户执行 Midjourney 任务,无需关注于账户的相关问题。
账户托管模式,将你的账户托管在TTAPI平台上执行Midjourney任务。具体区别详见 托管模式和PPU模式
生成图像[/imagine]
--cref 操作必须配合 --v 6.0 模型使用
托管模式的host与PPU模式不相同
POST
https://api.ttapi.io/midjourney/v1/imagine
Imagine 接口将根据文案生成4张图像。
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | 用以生成图像的提示词 例:a cat --ar 1:1 |
| string | 否 | 回调地址,任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
| string | 否 | 生成图像的任务模式,包括 relax、fast和turbo。如果未填写,则默认情况下将使用 fast 模式。 |
| int | 否 | 任务执行超时时间,单位:秒,范围 300 - 1200。 fast与turbo模式下默认与最小值为300 relax模式下默认与最小值为600。 |
| boolean | 否 | 是否获取四张小图,可选值为 true, false 默认为 false,对应的返回结果为JSON结构中images字段。注意:此操作并不是真正对生成的任务执行U操作,选择true之后依然可以进行U放大 |
| boolean | 否 | 是否翻译 true-翻译 false-不翻译 默认true |
如果 hookUrl 不为空,系统会向您设置的 hookUrl 发送一个 json响应。
请求示例
响应示例
图像变化[U1~U4、V1~V4]
POST
https://api.ttapi.io/midjourney/v1/action
此接口包含生成图像下方的按钮操作 例如:U1~U4,V1~V4等,具体可参考 Action操作
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | 上一步请求返回的jobId |
| string | 否 | |
| int | 否 | 请求超时时间,单位:秒。如果未填写,默认超时时间 300秒 |
| string | 否 | 任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
| boolean | 否 | 是否获取四张小图,可选值为 true, false 默认为 false,对应的返回结果为JSON结构中 |
请求示例
响应示例
获取图像种子[--seed]
POST
https://api.ttapi.io/midjourney/v1/seed
从 Midjourney 图像中获取种子,了解具体用法请参阅 Midjourney文档
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | 上一步请求返回的jobId |
| int | 否 | 请求超时时间,单位:秒。如果未填写,默认超时时间 300秒 |
| string | 否 | 任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
请求示例
响应示例
图像合成[/blend]
POST
https://api.ttapi.io/midjourney/v1/blend
上传2-5个图像,然后根据每个图像的概念和美学,将它们合并为一个新图像。
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| Array | 是 | 将要生成混图的图片Base64数组 数组长度为 2-5 例:[ "data:image/png;base64,xxx1", "data:image/png;base64,xxx2" ] |
| string | 否 | 生成图像的比例,包括PORTRAIT 、SQUARE、LANDSCAPE。如果未填写,默认使用SQUARE。 PORTRAIT 对应比例 2:3 SQUARE 对应比例 1:1 LANDSCAPE 对应比例 3:2 |
| string | 否 | 生成图像的任务模式,包括 relax、fast和turbo。如果未填写,则默认情况下将使用 fast 模式。 |
| string | 否 | 任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
| int | 否 | 请求超时时间,单位:秒。如果未填写,默认超时时间 300秒 |
请求示例
响应示例
图像描述词[/describe]
POST
https://api.ttapi.io/midjourney/v1/describe
上传图像,并根据该图像生成四个提示信息。
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 否 | 图像的base64编码 字符串"data:image/png;base64,"+ 图片base64值 例:"data:image/png;base64,xxx1" |
| string | 否 | 图片url地址 url参数与base64参数至少存在一个值不为空,若两个字段同时传值,默认取base64字段 |
| string | 否 |
|
| string | 否 | 任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
| int | 否 | 请求超时时间,单位:秒。如果未填写,默认超时时间 300秒 |
请求示例
响应示例
区域重绘[Vary(region)]
POST
https://api.ttapi.io/midjourney/v1/inpaint
区域重绘,等同midjourney的Vary(region)按钮
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | 上一步请求返回的jobId |
| string | 是 | 所选择图片的Base64值 提交的base64内容 是一张跟原图尺寸一样的黑白通道的蒙版(就是图中只包括黑色与白色) 其中白色部分是重绘圈出来的部分 其余部分是黑色 该base64值无需 “data:image/png;base64,”前缀 |
| string | 否 | 对所选择图片区域想要修改的描述 |
| int | 否 | 请求超时时间,单位:秒。如果未填写,默认超时时间 300秒 |
| string | 否 | 任务完成或失败将通过请地址进行通知。如果未设置,则需要请求fetch 接口进行查询。 |
请求示例
响应示例
获取任务状态 - fetch
POST
https://api.ttapi.io/midjourney/v1/fetch
查询任务结果,该接口不消耗quota,免费使用
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | 上一步请求返回的jobId |
请求示例
响应示例
返回结果与
异步回调
数据结构一致
Prompt效验 - Prompt Checker
POST
https://api.ttapi.io/midjourney/v1/promptCheck
效验imagine接口中的prompt,该接口不消耗quota,免费使用
Headers
Name | Value |
---|---|
TT-API-KEY | 用于请求授权 TT-API 的API密钥 |
Content-Type | application-json |
Body
参数 | 类型 | 是否必须 | 描述 |
---|---|---|---|
| string | 是 | prompt文案,注意:该效验目前只对英文文案有效 |
请求示例
响应示例
Action 具体使用操作
关于相关操作的具体用法,您可以详细阅读 Midjourney官方文档
异步回调 JSON 结构
自2023年12月1日开始,discord返回的cdn图片链接将在24-72小时之内过期。
自2024年09月13日开始,TTAPI的Midjourney服务的cdnImage
字段的域名由原来的 https://mjcdn.ttapi.io
变更至 https://cdnb.ttapi.io
返回JSON结构详解
name | value |
---|---|
status | PENDING_QUEUE //排队中 ON_QUEUE //执行中 SUCCESS //成功 FAILED //失败 |
progess | 进度 : 0-100,100为完成 |
components | |
discordImage | discord的cdn图片地址 |
cdnImage | 国内可访问的cdn代理地址 |
images | ttapi的cdn地址,imagine命令生成的四张小图 |
quota | 实际消耗额度 |
Last updated