API Docs
  1. Mid journey 文生图
API Docs
  • 指南
  • 获取 Base URL 和 API Key
  • 通知设置-WebHook参数介绍
  • 配置方式
  • 列出模型
    • Models(列出模型)
      GET
  • 聊天(Chat)
    • 所有对话模型均兼容 OpenAI 格式
    • Realtime (实时语音、对话
    • 聊天完成对象
    • 聊天完成块对象
    • 视觉语言模型介绍
    • Claude 官方格式
      • Messages(官方Anthropic格式)
      • Messages(识图)
      • Messages(思考)
      • Messages(函数调用)
    • GPTs
      • 简介
      • 通过关键词搜索 GPTs
      • 通过ID搜索 GPTs
      • 通过关键词搜索 GPTs V2
      • 通过ID搜索 GPTs V2
    • Chat(聊天)
      POST
    • Chat(流式返回)
      POST
    • Chat(分析图片)
      POST
    • Chat(结构化输出)
      POST
    • Chat(工具tools调用)
      POST
    • Chat(指定GPTs)
      POST
    • Chat(修改图片)
      POST
    • Chat(生成图片)
      POST
    • Chat(分析视频)
      POST
    • Chat(Claude Thinking)
      POST
    • gpt-3.5-turbo-instruct
      POST
  • RAG(嵌入、重排序
    • 嵌入(Embeddings)
      • 嵌入对象
      • 多模态向量嵌入
      • 创建嵌入
    • 重排序(Reranker)
      • 介绍
      • rerank
  • 视频模型
    • 视频生成模型简介
    • pixverse
      • 通用版
        • 接入文档
        • 生成任务
        • 查询任务(免费
        • 创建角色
      • 简单版
        • 接入文档
        • Generate(图生视频
        • Generate(文生视频
        • 获取进度(免费
    • 快手可灵(官方格式)
      • 对接教程
      • Callback协议
      • 绘图、虚拟试穿请看绘图模型-可灵
      • 文生视频
      • 图生视频
      • 视频延长
      • 对口型
      • 视频特效
      • 查询任务(免费
    • Luma 文生视频
      • 官方接口格式
        • 任务查询
          • 查询单个任务(免费
          • 批量获取任务(免费
        • 提交生成视频任务
        • 扩展视频
        • 提交生成视频任务-异步
        • 获取视频无水印链接(VIP版才支持)(废弃,查询接口有返回
      • GoAmzAI格式(兼容版,开发接入请勿对接
        • 生成视频 (兼容版,开发接入请勿对接
        • 获取视频(免费
    • 智谱清影 文生视频
      • 生成(generations)
      • 查询(async-result)(免费
      • 查询(async-result) 批量(免费
    • Runway
      • 官方格式
        • 接入介绍
        • 提交视频生成任务
        • 查询视频任务(免费
      • 简单版(goamz/rocket
        • style 列表
        • generate(文生视频
        • generate(参考图片)
        • 查询视频任务(免费
        • video2video(视频转视频 风格重绘
        • Act-one 表情迁移
    • Viggle 舞蹈合成
      • 介绍
      • Pro 无水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果(免费
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
      • 普通版 有水印
        • 上传舞蹈视频
        • 创建舞蹈视频任务
        • 上传角色图片
        • 获取任务进度、结果
        • 获取官方舞蹈视频模版-获取tag
        • 获取官方舞蹈视频模版-获取tag下的模版
    • Pika
      • 通用版
        • 接入介绍
        • generate (文生视频\图生视频\视频生视频)
        • 获取pika affect列表(免费
        • 查询视频任务(免费
  • 数字人
    • 简介
    • 生成数字人视频
    • 获取任务详情(免费
    • 查询默认 voice 列表(免费
  • 绘图模型
    • 生图模型简介
    • OpenAI Dall-e 格式
      • Flux
      • Recraftv3
      • 生图
      • 图像编辑(gpt-image-1)
    • OpenAI 聊天格式
      • Chat(兼容Flux)
      • Chat(兼容Recraftv3)
      • Chat(兼容Dalle3\Dalle2)
    • Mid journey 文生图
      • Midjourney接入向导
      • 补充 其他参数以及回调
      • 换脸任务提交
        • 提交swap_face任务
      • 任务提交
        • 绘图变化(UPSCALE; VARIATION; REROLL)
        • 执行动作(所有的关联按钮动作UPSCALE; VARIATION; REROLL; ZOOM等)
        • 绘图变化-simple(UPSCALE; VARIATION; REROLL)
        • 提交Blend任务(图生图)
        • 提交Describe任务(图生文)
        • 提交Imagine任务(文生图、文图生图)
        • 提交Modal(提交局部重绘、ZOOM)
        • 提交Shorten任务(prompt分析)
      • 任务查询(免费
        • 根据ID列表查询任务(免费
        • 指定ID获取任务(免费
        • 获取任务图片的seed(免费
    • Flux 文生图
      • Openai Dalle3 格式
      • Replicate 格式
      • Openai Chat 格式
    • Ideogram(官方格式
      • Generate 3.0(文生图)
      • Edit 3.0(编辑)
      • Remix 3.0(混合图)
      • Reframe 3.0(重构)
      • Replace Background 3.0(背景替换)
      • ideogram(文生图)
      • Remix(混合图)
      • Upscale(放大高清)
      • Describe(描述)
      • Edit(编辑)
    • recraft 官方格式
      • 附录
      • Generate Image(生成图片)
      • Vectorize Image(矢量化图片)
      • Remove Background(删除背景)
      • Clarity Upscale(清晰度提升)
      • Generative Upscale(生成高清)
      • Create style(创建样式)
    • 快手可灵(官方格式)
      • Callback协议
      • 简介
      • 视频、对口型请看视频模型-可灵
      • 虚拟试穿
      • 图像生成
      • 查询任务(免费
    • SeedEdit(图片编辑
      • Dall-e 格式
      • OpenAI 聊天格式
    • Replicate
      • 接入教程
      • 获取任务进度(predictions (免费
      • 创建任务-通过模型version(predictions)
      • 创建任务-通过url路径
      • 创建任务-stability-ai/stable-diffusion
      • 创建任务-stability-ai/sdxl
      • 创建任务-stability-ai/stable-diffusion-inpainting
      • 创建任务-stability-ai/stable-diffusion-img2img
      • 创建任务-lucataco/flux-schnell-lora
      • 创建任务-lucataco/flux-dev-lora
      • 创建任务-andreasjansson/stable-diffusion-animation
      • 创建任务-lucataco/animate-diff
      • 创建任务-sujaykhandekar/object-removal
      • 创建任务-cjwbw/rembg
      • 创建任务-black-forest-labs/flux-1.1-pro
      • 创建任务-black-forest-labs/flux-1.1-pro-ultra
      • 创建任务-black-forest-labs/flux-dev
      • 创建任务-black-forest-labs/flux-pro
      • 创建任务-black-forest-labs/flux-schnell
      • 创建任务-minimax/video-01-live
      • 创建任务-minimax/video-01
      • 创建任务-recraft-ai/recraft-v3
      • 创建任务-recraft-ai/recraft-v3-svg
      • 创建任务-ideogram-ai/ideogram-v2-turbo
    • 豆包智能绘图
      • 能力介绍&计费说明
      • 同步请求例子: SeedEdit
      • 异步请求提交例子: SeedEdit
      • 异步请求查询例子: SeedEdit
      • 即梦3.0
      • 通用2.1-文生图
      • 通用2.0Pro-指令编辑(SeedEdit)
      • 通用2.0Pro-文生图
      • 通用2.0-角色特征保持
      • 通用2.0-文生图
      • 通用2.0Pro-图生图
      • 通用1.4-角色特征保持
      • 通用1.4-文生图
      • 动漫1.3.X-文生图/图生图
      • 通用XL pro-图生图
      • 通用XL pro-文生图
      • AI营销商品图
      • 单图写真(pv版
      • inpainting涂抹消除
      • inpainting涂抹编辑
      • outpainting智能扩图
      • 实时生图-图生图
  • 音频接口
    • Suno文生歌
      • 设置 suno 版本
      • 常用格式
        • 补充
        • 场景应用
        • 任务提交
          • 音乐生成参数介绍
          • 生成歌曲(灵感模式)
          • 生成歌曲(自定义模式)
          • 生成歌曲(续写模式)
          • 生成歌词
          • 上传音乐
          • 歌曲拼接
        • 任务查询(免费
          • 批量获取任务
          • 查询单个任务
      • V1
        • 生成歌曲(灵感模式)
        • 生成歌曲(自定义模式)
        • 生成歌曲(续写模式)
        • 查询
        • 生成歌词
        • 查询歌词
        • 生成歌曲(拼接歌曲)
    • OpenAI(TTS\Wishper
      • 创建语音(tts
      • 创建转录(whisper
      • 创建翻译(whisper
  • 文件上传(Files)
    • README
    • 文件对象
    • 上传文件
  • PPT接口
    • 文多多(官方格式)
      • 介绍
      • 分页查询 PPT 模板(免费
      • 更换 PPT 模板(免费
      • 修改大纲(免费
      • 解析文件内容(免费
      • 生成大纲(免费
      • 生成大纲内容(免费
      • 随机 PPT 模板(免费
      • 获取 PPT 列表(免费
      • 加载 PPT 数据(免费
      • 下载 PPT(免费
      • 更新 PPT 属性(免费
      • 保存 PPT(免费
      • 删除PPT(免费
      • 生成大纲内容同时异步生成PPT(免费
      • 查询异步生成PPT信息(免费
      • ppt转json(免费
      • json转ppt
  • 帮助中心
    • 常见问题及解决办法
  • 平台API
    • 获取用户信息(余额
  • 废弃、未开放
    • Vidu(官方格式)
      • 普通
        • 创建视频(tasks)
        • 高清视频(tasks)
        • 视频状态(state)
        • 视频查询(tasks-get)
    • Udio文生歌
      • 接入流程
      • 根据描述创建音乐
      • 根据歌词创建音乐
      • 音乐续写
      • 获取任务进度(免费
    • Sora
      • 创建视频
      • 查询视频任务(免费
  1. Mid journey 文生图

补充 其他参数以及回调

代理 MidJourney 的discord频道,实现api形式调用AI绘图#

API接口说明#

同时支持 Mid journey proxy Plus 以及 Mid journey proxy 接口协议
默认地址例子: https://{BASE_URL}/mj/submit/imagine
此处补充

快速教学-完整流程一遍过#

可按照以下步骤快速熟悉MJ流程。
一、使用Imagine接口进行绘图,会响应一个任务id
二、使用查询任务接口查询任务ID获得绘图结果,结果里可以得到图片链接和可以操作的按钮。每个操作对应单独的custiom_id。
三、如果想对图片操作,调用Action接口;使用刚才查询任务时获得的custom_id和任务id,进行操作,会得到新的任务ID,重复第二步继续对新任务查询任务结果。
(如果调用Action接口,提示弹窗,需要使用这个任务ID再次调用Modal接口。)
切换 MJ mode, 两种方式:
1.
通过 URL 路径切换
默认 /mj 是 fast mode
/mj-fast/mj 是 fast mode
/mj-turbo/mj 是 turbo mode
/mj-relax/mj 是 relax mode
例如: https://{BASE_URL}/mj-turbo/mj/submit/imagine
2.
在令牌编辑,选择绘图模式(推荐)
优先级: 令牌 > 路径 > 系统默认
切换 MJ 返回的图片地址:
1.
通过 URL 路径切换
默认 /mj 是管理员设置默认方式
/mj-{mode}-relay/mj 是使用服务转发地址,图片国内访问较快
/mj-{mode}-origin/mj 是使用discord 原地址,图片国外访问很快
/mj-{mode}-proxy/mj 是使用管理员设置的代理地址,图片国内访问较快
例如: https://{BASE_URL}/mj-turbo-proxy/mj/submit/imagine
例如: https://{BASE_URL}/mj-proxy/mj/submit/imagine
通常,应用程序是填写 /mj/ 前的地址
例如:
https://{BASE_URL}
https://{BASE_URL}/mj-turbo-proxy
2. 在令牌编辑,选择图片代理(推荐,可以设置自定义图片代理)
优先级: 令牌 > 路径 > 系统默认
创建新的绘画任务:
1.
Blend、Describe、Imagine
2.
查询任务进度
3.
执行动作或绘图变化或提交Model
4.
查询子任务进度

1. 数据结构#

任务#

字段类型示例描述
idstring1689231405853400任务ID
actionstringIMAGINE任务类型: IMAGINE(绘图)、UPSCALE(放大)、VARIATION(变化)、ZOOM(图片变焦)、PAN(焦点移动)、DESCRIBE(图生文)、BLEND(图片混合)、SHORTEN(prompt分析)、SWAP_FACE(人脸替换)
statusstringSUCCESS任务状态: NOT_START(未启动)、SUBMITTED(已提交处理)、MODAL(窗口等待)、IN_PROGRESS(执行中)、FAILURE(失败)、SUCCESS(成功)、CANCEL(已取消)
promptstring猫猫提示词
promptEnstringCat英文提示词
descriptionstring/imagine 猫猫任务描述
submitTimenumber1689231405854提交时间
startTimenumber1689231442755开始执行时间
finishTimenumber1689231544312结束时间
progressstring100%任务进度
imageUrlstringhttps://cdn.discordapp.com/attachments/xxx/xxx/xxxx.png生成图片的url, 成功或执行中时有值,可能为png或webp
failReasonstring[Invalid parameter] Invalid value失败原因, 失败时有值
propertiesobject{"finalPrompt": "Cat"}任务的扩展属性,系统内部使用
buttonsButton[][]任务完成后的可执行按钮

Button#

字段类型示例描述
customIdstringMJ::JOB::upsample::1::85a4b4c1-8835-46c5-a15c-aea34fad1862动作标识
emojistring🪄图标
labelstringMake Variations文本
typenumber2类型,系统内部使用
stylenumber2样式: 2(Primary)、3(Green)

properties 常见字段#

字段类型示例描述
botTypestringNIJI_JOURNEYbot类型: MID_JOURNEY,NIJI_JOURNEY,INSIGHT_FACE
discordInstanceIdstring1118138338562560102执行该任务的实例ID(频道ID)
finalPromptstringCat消息内容提取出的prompt
messageIdstring1174910863984033903消息ID
messageContentstring**Cat** - Image #1 <@590422081204912129>消息内容

2. 任务提交返回#

code=1: 提交成功,result为任务ID
{
  "code": 1,
  "description": "提交成功",
  "result": "14001929738841620",
  "properties": {
      "discordInstanceId": "1118138338562560102"
  }
}
code=22: 提交成功,进入队列等待
{
    "code": 22,
    "description": "排队中,前面还有1个任务",
    "result": "14001929738841620",
    "properties": {
        "numberOfQueues": 1,
        "discordInstanceId": "1118138338562560102"
     }
}
code=23: 队列已满,请稍后尝试
{
    "code": 23,
    "description": "队列已满,请稍后尝试",
    "result": "14001929738841620",
    "properties": {
        "discordInstanceId": "1118138338562560102"
     }
}
code=24: prompt包含敏感词
{
    "code": 24,
    "description": "可能包含敏感词",
    "properties": {
        "promptEn": "nude body",
        "bannedWord": "nude"
     }
}
other: 提交错误,description为错误描述

3. 执行任务的关联动作#

调用 /mj/submit/action,几乎所有的button都做了支持,除了以下情况:
图生文结果的 🎉Imagine all
图片放大后的 ❤️
{
  // 关联任务的ID
  "taskId": "1689216801333574",
  // 动作标识
  "customId": "MJ::JOB::reroll::0::1c6dff5e-5632-40c6-9d4c-afb261705313::SOLO"
}
⚠️ 注意: 某些场景需要modal弹框确认
执行CustomZoom(自定义变焦)
执行️Region(局部重绘)
执行PicReader(Describe后选择生图)
执行PromptAnalyzer(Shorten后选择生图)
开启Remix模式时,执行Reroll、Variation、Pan也需要弹框确认;但账号设置了remix自动提交时,不需要确认
需要确认时返回的code为 21,示例:
{
  "code": 21,
  "description": "窗口等待",
  "result": "14001929738841620"
}
该任务状态为MODAL,但不会进队列影响并发。需调用/mj/submit/modal提交最终任务
{
  // 需确认的任务ID
  "taskId": "1689228047868174",
  // prompt: 为空时使用原任务的prompt
  "prompt": "Cat"
}
CustomZoom的prompt需要设置--zoom(1到2之间),例如: Cat --zoom 1.5
️Vary (Region) 需要额外传maskBase64: 局部重绘的蒙版base64(底色纯黑,选中区域纯白)

4. /mj/submit/describe 图生文#

{
  // 图片的base64字符串
  "base64": "data:image/png;base64,xxx"
}
后续任务完成后,properties中finalPrompt即为图片生成的prompt,finalZhPrompt为翻译的中文
{
  "id":"14001929738841620",
  "action":"DESCRIBE",
  "status": "SUCCESS",
  "description":"/describe 14001929738841620.png",
  "imageUrl":"https://cdn.discordapp.com/attachments/xxx/xxx/14001929738841620.png",
  "properties": {
    "finalPrompt": "1️⃣ Cat --ar 5:4\n\n2️⃣ Cat2 --ar 5:4\n\n3️⃣ Cat3 --ar 5:4\n\n4️⃣ Cat4 --ar 5:4",
    "finalZhPrompt": "1️⃣ 猫 --ar 5:4\n\n2️⃣ 猫2 --ar 5:4\n\n3️⃣ 猫3 --ar 5:4\n\n4️⃣ 猫4 --ar 5:4"
  }
  // ...
}

5. /mj/submit/shorten prompt分析#

{
  "prompt": "️appdash appdash, in the style of expert draftsmanship, commission for, ethereal, dreamlike quality, dadaistic, toonami"
}
后续任务完成后,properties中finalPrompt即为分析结果,finalZhPrompt为翻译的中文
{
  "id":"1689252749098647",
  "action":"SHORTEN",
  "status": "SUCCESS",
  "description":"/shorten appdash appdash, in the style of expert draftsmanship, commission for, ethereal, dreamlike quality, dadaistic, toonami",
  "properties": {
    "finalPrompt": "## Important tokens\n**appdash** **appdash**, in the ~~style~~ of ~~expert~~ **draftsmanship**, commission for, ethereal, dreamlike quality, ~~dadaistic~~, **toonami**\n## Shortened prompts\n1️⃣ appdash appdash, draftsmanship, commission for, ethereal, toonami\n\n2️⃣ appdash appdash, draftsmanship, commission, toonami\n\n3️⃣ appdash appdash, draftsmanship, toonami\n\n4️⃣ appdash appdash, toonami\n\n5️⃣ appdash appdash",
    "finalZhPrompt": "## 重要词汇\n**appdash** **appdash**,以专家的绘画风格,委托制作,飘渺的,梦幻般的质感,达达主义的,**toonami**\n## 简化提示\n1️⃣ appdash appdash,绘画风格,委托制作,飘渺的,toonami\n\n2️⃣ appdash appdash,绘画风格,委托制作,toonami\n\n3️⃣ appdash appdash,绘画风格,toonami\n\n4️⃣ appdash appdash,toonami\n\n5️⃣ appdash appdash"
  }
  // ...
}
对该任务执行 Show Details 动作,能获得进一步的分析结果
{
  "id":"1689253263953453",
  "action":"SHORTEN",
  "status": "SUCCESS",
  "description":"/up 168925266642808397 Show Details",
  "properties": {
    "finalPrompt": "## Important tokens\n**appdash** (1.00) **appdash** (0.79), in the style (0.01) of expert (0.00) **draftsmanship** (0.09), commission (0.08) for, ethereal (0.05), dreamlike (0.02) quality (0.01), dadaistic (0.01), **toonami** (0.19)\n\n██████████ appdash\n████████░░ appdash\n██░░░░░░░░ toonami\n█░░░░░░░░░ draftsmanship\n█░░░░░░░░░ commission\n█░░░░░░░░░ ethereal\n## Shortened prompts\n1️⃣ appdash appdash, draftsmanship, commission for, ethereal, toonami\n\n2️⃣ appdash appdash, draftsmanship, commission, toonami\n\n3️⃣ appdash appdash, draftsmanship, toonami\n\n4️⃣ appdash appdash, toonami\n\n5️⃣ appdash app",
    "finalZhPrompt": "## 重要的词语\n**appdash** (1.00) **appdash** (0.79),以专家级(0.01) **绘画技巧** (0.09) 的风格,委托(0.08) 制作,飘渺的(0.05),梦幻般的(0.02) 质感(0.01),达达主义的(0.01),**toonami** (0.19)\n\n██████████ appdash\n████████░░ appdash\n██░░░░░░░░ toonami\n█░░░░░░░░░ draftsmanship\n█░░░░░░░░░ commission\n█░░░░░░░░░ ethereal\n## 简化的提示\n1️⃣ appdash appdash,绘画技巧,委托制作,飘渺,toonami\n\n2️⃣ appdash appdash,绘画技巧,委托制作,toonami\n\n3️⃣ appdash appdash,绘画技巧,toonami\n\n4️⃣ appdash appdash,toonami\n\n5️⃣ appdash appdash"
  }
  // ...
}

6. 获取任务图片的seed#

绘图任务执行后,不会设置seed,如需获取seed,需要执行 /mj/task/{id}/image-seed
code=1: 获取成功,result为图片对应的seed
{
  "code": 1,
  "description": "成功",
  "result": "636646138"
}
other: 执行错误,description为错误描述

7. 任务变更回调#

任务状态变化或进度改变时,会调用业务系统的接口
任务提交时支持传notifyHook以改变此任务的回调地址
两者都为空时,不触发回调
回调地址不可为 ip 地址,需要有域名,最好是https
POST application/json
{
  "id": "14001929738841620",
  "action": "IMAGINE",
  "status": "SUCCESS",
  "prompt": "猫猫",
  "promptEn": "Cat",
  "description": "/imagine 猫猫",
  "submitTime": 1689231405854,
  "startTime": 1689231442755,
  "finishTime": 1689231544312,
  "progress": "100%",
  "imageUrl": "https://cdn.discordapp.com/attachments/xxx/xxx/xxxx.png",
  "failReason": null,
  "properties": {
    "finalPrompt": "Cat"
  },
  "buttons": []
}
修改于 2024-12-28 06:50:29
上一页
Midjourney接入向导
下一页
提交swap_face任务
Built with