Midjourney非官方websocket api接口 0.3.0

Midjourney非官方websocket api接口

支持bot:

  1. 🤖 Midjourney Bot
  2. 🤖 niji・journey Bot

支持功能:

  1. ✅ 画图(即imagine)
  2. ✅ 图片放大(即u1,u2,u3,u4)
  3. ✅ 图片变化(即v1,v2,v3,v4)
  4. ✅ 图片重画(即reroll)
  5. ✅ 以图生图(即垫图,基于已有图片作画)
  6. ✅ 获取图片描述(即图生文,给定图片获取描述)

注意事项:

  1. 鉴权需要的access keysecret key请登录后台生成
  2. 客户端在建立websocket连接后,应该立即发送auth消息进行鉴权,如果鉴权失败,server会主动断开连接。
  3. 客户端每隔5秒发送心跳消息,否则server会断开连接。
  4. 客户端需要在ws连接因意外断开后使用session_id重连,否则可能丢失消息。

Servers

  • wss://midjourney-api.ai3.design/ws?mode=devwssdev

    开发接口,基于慢速模式作图,返回较慢,仅用于对接测试!

  • wss://midjourney-api.ai3.design/wswssprod

    真实接口,消耗Fast额度,正式环境请使用此接口!

Operations

  • PUB /

    客户端发送给server端的消息列表

    Accepts one of the following messages:

    • #0auth

      客户端在建立连接后,应该首先发送鉴权消息

      object

      Examples

    • #1heartbeat

      客户端应该每隔5s发送心跳消息给server,超时server会断开连接

      object

      Examples

    • #2interaction

      客户端发送给server的interaction消息,用于发起作图任务

      object

      Examples

  • SUB /

    服务器返回给客户端的消息列表

    Accepts one of the following messages:

    • #0error

      服务端返回的错误消息,仅用于表示本服务的错误,不代表midjourney返回的错误

      object

      Examples

    • #1info

      服务器端返回的账号订阅信息

      object

      Examples

    • #2taskReceipt

      客户端向server提交interaction后,服务端会返回一个task回执便于客户端追踪任务进度

      object

      Examples

    • #3taskResponse

      作图任务的进度响应

      object

      Examples

Messages

  • #1auth

    客户端在建立连接后,应该首先发送鉴权消息

    object
  • #2heartbeat

    客户端应该每隔5s发送心跳消息给server,超时server会断开连接

    object
  • #3interaction

    客户端发送给server的interaction消息,用于发起作图任务

    object
  • #4error

    服务端返回的错误消息,仅用于表示本服务的错误,不代表midjourney返回的错误

    object
  • #5info

    服务器端返回的账号订阅信息

    object
  • #6taskReceipt

    客户端向server提交interaction后,服务端会返回一个task回执便于客户端追踪任务进度

    object
  • #7taskResponse

    作图任务的进度响应

    object

Schemas

  • messageTypeAuth
    integer
    uid: messageTypeAuth

    客户端鉴权消息类型

    Const:7
  • messageTypeHeartbeat
    integer
    uid: messageTypeHeartbeat

    心跳消息类型

    Const:1
  • messageTypeInfo
    integer
    uid: messageTypeInfo

    账号额度消息类型

    Const:2
  • messageTypeError
    integer
    uid: messageTypeError

    错误消息类型

    Const:3
  • messageTypeInteraction
    integer
    uid: messageTypeInteraction

    交互任务消息类型

    Const:4
  • messageTypeTaskReceipt
    integer
    uid: messageTypeTaskReceipt

    任务回执消息类型

    Const:5
  • messageTypeTaskResponse
    integer
    uid: messageTypeTaskResponse

    任务响应消息类型

    Const:6
  • interactionType
    integer
    uid: interactionType

    交互任务的类型

    • 1: 绘图
    • 2: 获取图片
    • 3: 微调
    • 4: 重画
    • 7: 图生文
      Allowed values:
    • 1
    • 2
    • 3
    • 4
    • 7
  • interactionStatus
    integer
    uid: interactionStatus

    交互任务的状态

    • 1: 发生错误
    • 2: 已提交(保留值)
    • 3: 处理中
    • 4: 已完成
      Allowed values:
    • 1
    • 2
    • 3
    • 4
  • subscribeMode
    integer
    uid: subscribeMode

    账号订阅信息:

    • 0: 有效期内无限Fast作图额度
    • 1: 有效期内有限Fast作图额度
    • 2: 有限Fast作图额度 无有效期限制
      Allowed values:
    • 0
    • 1
    • 2
  • mode
    string
    uid: mode

    两种执行模式,慢速和快速

    Default value:"Fast"
      Allowed values:
    • "Relaxed"
    • "Fast"
  • object
    uid: auth

    客户端鉴权数据

  • object
    uid: error

    服务器返回的错误,非midjourney的错误

  • object
    uid: task

    任务回执

  • object
    uid: taskResponse

    任务进度响应

  • object
    uid: info

    账号的订阅信息

  • object
    uid: heartbeat

    客户端的心跳数据

  • object
    uid: interaction

    客户端发送给server的interaction,比如imagine

  • object
    uid: imagine

    通过提示词生成图片

  • object
    uid: upscale

    获取指定的图片

  • object
    uid: vary

    对指定的图片进行微调

  • object
    uid: reroll

    重新生成图片

  • object
    uid: describe

    给定图片地址, 获取图片的4段描述文本.

  • object
    uid: imageDescription

    图片的描述结果

  • object
    uid: progress

    交互命令imagine, vary, reroll的通用返回,完成的交互任务process_num等于100

  • object
    uid: image

    midjourney生成的图片对象

  • object
    uid: interactionError

    midjourney返回的错误信息