Midjourney 画像フォーマット（Midjourney Proxy/Midjourney Proxy Plus）

ご注意ください

このインターフェースは Midjourney公式のインターフェースではありません。著者 novicezk のオープンソースプロジェクト midjourney-proxy に基づいて実装されたMidjourneyプロキシインターフェースです。

このプロジェクトには2つのバージョンがあり、88APIは両方に対応しています：

オープンソース版 midjourney-proxy
有料版 midjourney-proxy-plus

Midjourneyの強力な機能を便利に利用できるようにしてくださった著者の貢献に深く感謝します。もし時間があれば、著者にStarを贈り、能力があれば、より多くの機能をサポートしている有料版の支援をご検討ください。

機能カテゴリ	オープンソース版	有料版
基本機能
Imagineコマンドおよび関連アクション	✓	✓
参照画像（インプット画像）のサポート	✓	✓
Blend（画像混合）	✓	✓
Describe（画像からテキスト生成）	✓	✓
タスクのリアルタイム進捗	✓	✓
中国語プロンプト翻訳	✓	✓
プロンプトの機密語句検出	✓	✓
user-tokenによるwss接続	✓	✓
複数アカウント設定	✓	✓
高度な機能
Shorten（プロンプト分析）	✗	✓
焦点移動（Pan）	✗	✓
画像ズーム（Zoom）	✗	✓
部分的な再描画（Vary Region）	✗	✓
関連ボタンアクションとRemixモード	✗	✓
画像シード値の取得	✗	✓
アカウント管理
アカウントプールの永続化	✗	✓
多様なストレージサポート(Redis/MySQL)	✗	✓
アカウント情報の取得と設定	✗	✓
タスクキャンセル機能	✗	✓
内蔵管理バックエンド	✗	✓
スマート機能
MJ V6.0サポート	✗	✓
アカウントステータスの自動監視	✗	✓
モードの自動切り替え	✗	✓
niji・journey Botサポート	✗	✓
InsightFace顔認識サービス	✗	✓
セキュリティ性能
動的設定のサポート	✗	✓
トークン切断問題の修正	✗	✓
自動検証機能	✗	✓
禁止語句の自動異議申し立て	✗	✓

📝 概要

Midjourneyは強力な画像生成および処理モデルであり、自然言語の記述に基づいて画像を生成、編集、修正することができます。異なるインターフェースを提供することで、様々な画像生成および処理タスクを実現できます。

🔄 フローチャート

graph TD
    A[开始] --> B{选择任务类型}

    %% Imagine 流程
    B -->|文生图| C[提交 Imagine 任务]
    C --> D[获得初始图片]
    D --> E{选择操作}

    %% 基础操作分支
    E -->|U1-U4| F[放大]
    E -->|V1-V4| G[变体]

    %% Blend 流程
    B -->|图片混合| H[提交 Blend 任务]
    H --> D

    %% Describe 流程
    B -->|图生文| I[提交 Describe 任务]
    I --> J[获得图片描述]

    %% Action & Modal 流程
    F --> K[提交 Action]
    G --> K
    K -->|需要弹窗| L[提交 Modal]
    K -->|直接执行| M[执行完成]
    L --> M

    %% Face Swap 流程
    B -->|人脸替换| N[提交 Swap Face 任务]
    N --> M

    %% 查询相关
    M --> O{后续操作}
    O -->|查询进度| P[获取任务详情]
    O -->|获取种子| Q[获取图片 Seed]
    O -->|保存图片| R[上传至 Discord]

    %% 样式定义
    classDef process fill:#f9f,stroke:#333,stroke-width:2px
    classDef decision fill:#bbf,stroke:#333,stroke-width:2px
    classDef endpoint fill:#bfb,stroke:#333,stroke-width:2px

    class A,M,J,R endpoint
    class B,E,O decision
    class C,D,F,G,H,I,K,L,N,P,Q process

フローの説明

初期タスク
- Imagine: テキストから画像を生成
- Blend: 複数画像の混合
- Describe: 画像の説明生成
- Swap Face: 顔の入れ替え
画像処理
- U1-U4: 拡大操作
- V1-V4: バリエーション生成
- Pan: 画像のパン（平移）
- Zoom: 画像のズーム
特殊なフロー
- Action + Modal: ポップアップ確認が必要な操作
- Action 直接実行: ポップアップが不要な操作
タスク管理
- タスク詳細の取得
- 画像シードの取得
- Discordへのアップロード

💡 リクエスト例

Imagineタスクの送信 ✅

curl --location --request POST 'https://88api.ai/mj/submit/imagine' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "botType": "MID_JOURNEY",
  "prompt": "Cat",
  "base64Array": [],
  "accountFilter": {
    "channelId": "",
    "instanceId": "",
    "modes": [],
    "remark": "",
    "remix": true,
    "remixAutoConsidered": true
  },
  "notifyHook": "",
  "state": ""
}'

応答例:

{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Blendタスクの送信 ✅

curl --location --request POST 'https://88api.ai/mj/submit/blend' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "botType": "MID_JOURNEY",
  "base64Array": [
    "data:image/png;base64,xxx1",
    "data:image/png;base64,xxx2"
  ],
  "dimensions": "SQUARE",
  "accountFilter": {
    "channelId": "",
    "instanceId": "",
    "modes": [],
    "remark": "",
    "remix": true,
    "remixAutoConsidered": true
  },
  "notifyHook": "",
  "state": ""
}'

応答例:

{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Describeタスクの送信 ✅

curl --location --request POST 'https://88api.ai/mj/submit/describe' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "botType": "MID_JOURNEY",
  "base64": "data:image/png;base64,xxx",
  "accountFilter": {
    "channelId": "",
    "instanceId": "",
    "modes": [],
    "remark": "",
    "remix": true,
    "remixAutoConsidered": true
  },
  "notifyHook": "",
  "state": ""
}'

応答例:

{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

Modalの送信 ✅

curl --location --request POST 'https://88api.ai/mj/submit/modal' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "maskBase64": "",
  "prompt": "",
  "taskId": "14001934816969359"
}'

応答例:

{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

swap_faceタスクの送信 ✅

curl --location --request POST 'https://88api.ai/mj/insight-face/swap' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "sourceBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RDnYdriP1wsS81kwU8OVs/R3xu8s6bX7+zYnOH8coSqpmRSBjqerjcBlr2OB/lbAf/2Q==",
  "targetBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD849k="
}'

応答例:

{
  "code": 0,
  "description": "string",
  "result": "string"
}

Actionアクションの実行 ✅

curl --location --request POST 'https://88api.ai/mj/submit/action' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "chooseSameChannel": true,
  "customId": "MJ::JOB::upsample::1::82c51c9d-bc33-4c07-a471-36c3dcb1a6f0",
  "taskId": "1728781324658687",
  "accountFilter": {
    "channelId": "",
    "instanceId": "",
    "modes": [],
    "remark": "",
    "remix": true,
    "remixAutoConsidered": true
  },
  "notifyHook": "",
  "state": ""
}'

応答例:

{
  "code": 1,
  "description": "提交成功",
  "properties": {},
  "result": 1320098173412546
}

ファイルをDiscordにアップロード ✅

curl --location --request POST 'https://88api.ai/mj/submit/upload-discord-images' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "base64Array": [],
  "filter": {
    "channelId": "",
    "instanceId": "",
    "remark": ""
  }
}'

応答例:

{
  "code": 0,
  "description": "string",
  "result": ["string"]
}

IDリストによるタスクの照会 ✅

curl --location --request POST 'https://88api.ai/mj/task/list-by-condition' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  "ids": []
}'

応答例:

[
  {
    "action": "IMAGINE",
    "buttons": [
      {
        "customId": "string",
        "emoji": "string",
        "label": "string",
        "style": 0,
        "type": 0
      }
    ],
    "description": "string",
    "failReason": "string",
    "finishTime": 0,
    "id": "string",
    "imageUrl": "string",
    "progress": "string",
    "prompt": "string",
    "promptEn": "string",
    "properties": {},
    "startTime": 0,
    "state": "string",
    "status": "NOT_START",
    "submitTime": 0
  }
]

指定IDによるタスクの取得 ✅

curl --location --request GET 'https://88api.ai/mj/task/{id}/fetch' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'

応答例:

{
  "action": "IMAGINE",
  "buttons": [
    {
      "customId": "string",
      "emoji": "string",
      "label": "string",
      "style": 0,
      "type": 0
    }
  ],
  "description": "string",
  "failReason": "string",
  "finishTime": 0,
  "id": "string",
  "imageUrl": "string",
  "progress": "string",
  "prompt": "string",
  "promptEn": "string",
  "properties": {},
  "startTime": 0,
  "state": "string",
  "status": "NOT_START",
  "submitTime": 0
}

タスク画像のシードの取得 ✅

curl --location --request GET 'https://88api.ai/mj/task/{id}/image-seed' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--header 'Content-Type: application/json'

応答例:

{
  "code": 0,
  "description": "string",
  "result": "string"
}

POST /mj/submit/imagine

テキストプロンプトに基づいて画像を生成します。

Blendタスクの送信

POST /mj/submit/blend

複数の入力画像を融合して新しい画像を生成します。

Describeタスクの送信

POST /mj/submit/describe

入力画像に基づいてテキストの説明を生成します。

Modalの送信

POST /mj/submit/modal

モーダル情報を送信し、画像生成の詳細を調整するために使用します。

swap_faceタスクの送信

POST /mj/insight-face/swap

ソース画像とターゲット画像に基づいて顔の交換を実行します。

Actionアクションの実行

POST /mj/submit/action

既に生成された画像に対して、拡大や調整などの後続操作を実行します。

ファイルをDiscordにアップロード

POST /mj/submit/upload-discord-images

画像をDiscordプラットフォームにアップロードします。

IDリストによるタスクの照会

POST /mj/task/list-by-condition

指定されたタスクIDリストに基づいてタスクの詳細を照会します。

指定IDによるタスクの取得

GET /mj/task/{id}/fetch

タスクIDに基づいてタスクの詳細を取得します。

タスク画像のシードの取得

GET /mj/task/{id}/image-seed

指定されたタスクによって生成された画像のシード値を取得します。

認証方法

リクエストヘッダーに以下を含めてAPIキー認証を行います：

Authorization: Bearer $API_KEY$OPENAI_API_KEY

ここで $OPENAI_API_KEY はあなたのAPIキーです。

タイプ：列挙型文字列
必須：いいえ
デフォルト値：MID_JOURNEY
選択可能な値：
- MID_JOURNEY: Midjourneyモデル
- NIJI_JOURNEY: Niji Journeyモデル
説明：使用するbotのタイプを選択します

`prompt`

タイプ：文字列
必須：はい
説明：画像を生成するためのテキストプロンプト
ヒント：
- 明確で具体的な記述を使用してください
- アートスタイル、構図などの詳細を含めることができます
- 英語と中国語の入力に対応しています

`base64Array`

タイプ：文字列配列
必須：いいえ
説明：参照画像（インプット画像）のbase64エンコード配列
形式：各要素はMIMEタイププレフィックスを含む完全なbase64画像文字列である必要があります

`accountFilter`

タイプ：オブジェクト
必須：いいえ
属性：
- channelId: チャンネルID
- instanceId: アカウントインスタンスID
- modes: アカウントモード配列。選択可能な値：RELAX、FAST、TURBO
- remark: 備考に含まれる内容
- remix: アカウントがremixをサポートするかどうか
- remixAutoConsidered: remix自動送信設定

`notifyHook`

タイプ：文字列
必須：いいえ
説明：タスク完了後のコールバックアドレス。空の場合、グローバルのnotifyHookを使用します

`state`

タイプ：文字列
必須：いいえ
説明：カスタムステータスパラメータ。リクエストの追跡に使用できます

Blendタスクの送信

`base64Array`

タイプ：文字列配列
必須：はい
説明：混合する画像のbase64エンコード配列
形式：2〜5枚の画像のbase64文字列を含める必要があります

`dimensions`

タイプ：列挙型文字列
必須：いいえ
選択可能な値：
- PORTRAIT: 2:3の比率
- SQUARE: 1:1の比率
- LANDSCAPE: 3:2の比率
説明：出力画像の縦横比設定

Describeタスクの送信

`base64`

タイプ：文字列
必須：はい
説明：説明が必要な画像のbase64エンコード
形式：MIMEタイププレフィックスを含む完全なbase64文字列

Modalタスクの送信

`maskBase64`

タイプ：文字列
必須：いいえ
説明：部分的な再描画のためのマスク画像のbase64エンコード

`prompt`

タイプ：文字列
必須：いいえ
説明：再描画領域のテキストプロンプト

`taskId`

タイプ：文字列
必須：はい
説明：元のタスクのID

Swap Faceタスクの送信

`sourceBase64`

タイプ：文字列
必須：はい
説明：顔のソース画像のbase64エンコード
要件：画像にはっきりとした顔が含まれている必要があります

`targetBase64`

タイプ：文字列
必須：はい
説明：ターゲット画像のbase64エンコード
要件：画像には置き換えるべき顔が含まれている必要があります

Actionアクションの実行

`chooseSameChannel`

タイプ：ブール値
必須：いいえ
デフォルト値：false
説明：同じチャンネル下のアカウントを選択するかどうか

`customId`

タイプ：文字列
必須：はい
説明：アクション識別子
形式：特定の形式の文字列。例："MJ::JOB::upsample::1::xxx"

`taskId`

タイプ：文字列
必須：はい
説明：アクションを実行するタスクID

ファイルをDiscordにアップロード

`base64Array`

タイプ：文字列配列
必須：はい
説明：アップロードする画像のbase64エンコード配列

`filter`

タイプ：オブジェクト
必須：いいえ
属性：
- channelId: ターゲットチャンネルID
- instanceId: アカウントインスタンスID
- remark: 備考情報

IDリストによるタスクの照会

`ids`

タイプ：文字列配列
必須：はい
説明：照会するタスクIDのリスト

共通応答フォーマット

すべてのインターフェースは類似した応答構造を返します：

`code`

タイプ：整数
説明：ステータスコード

ステータスコード	説明
1	送信成功
22	タスクキューイング中
21	パラメータエラー
23	システムエラー
24	アカウント利用不可
25	残高不足

`description`

タイプ：文字列
説明：応答の説明情報

`properties`

タイプ：オブジェクト
説明：拡張属性

`result`

タイプ：文字列または配列
説明：返される結果。タスクIDまたはその他のデータである可能性があります

タイプ：列挙型文字列
説明：タスクタイプ

文字列値	説明
`IMAGINE`	画像の作成
`UPSCALE`	画像の拡大
`VARIATION`	バリエーション生成
`ZOOM`	画像のズーム
`PAN`	画像のパン（平移）
`DESCRIBE`	画像の説明生成
`BLEND`	画像の混合
`SHORTEN`	プロンプトの短縮
`SWAP_FACE`	顔の入れ替え

`buttons`

タイプ：オブジェクト配列
説明：実行可能な操作ボタン

配列に含まれる属性	説明
`customId`	アクション識別子
`emoji`	ボタンアイコン
`label`	ボタンテキスト
`style`	スタイル(2=Primary, 3=Green)
`type`	システム内部で使用されるタイプ

`description`

タイプ：文字列
説明：タスクの説明情報

`failReason`

タイプ：文字列
説明：タスクの失敗理由

`finishTime`

タイプ：整数
説明：タスク完了のタイムスタンプ

`id`

タイプ：文字列
説明：タスクの一意な識別子

`imageUrl`

タイプ：文字列
説明：生成された画像のURL

`progress`

タイプ：文字列
説明：タスクの進捗情報

`prompt`

タイプ：文字列
説明：元のプロンプト

`promptEn`

タイプ：文字列
説明：英語のプロンプト

`status`

タイプ：列挙型文字列
説明：タスクステータス

文字列値	説明
`NOT_START`	未開始
`SUBMITTED`	送信済み
`MODAL`	モーダル操作中
`IN_PROGRESS`	進行中
`FAILURE`	失敗
`SUCCESS`	成功
`CANCEL`	キャンセル済み

`submitTime`

タイプ：整数
説明：タスク送信のタイムスタンプ

`startTime`

タイプ：整数
説明：タスク実行開始のタイムスタンプ

エラー応答

リクエストに問題が発生した場合、APIはエラー応答を返します：

HTTPステータスコード

400 Bad Request: リクエストパラメータが無効です
401 Unauthorized: APIキーが無効または提供されていません
403 Forbidden: 権限が不足しています
404 Not Found: リソースが存在しません
429 Too Many Requests: リクエスト頻度が制限を超過しました
500 Internal Server Error: サーバー内部エラー

エラー応答フォーマット

{
  "code": `<エラーコード>`,
  "description": "エラーの説明情報",
  "result": null
}

💡 ベストプラクティス

プロンプト作成の推奨事項

期待する画像内容を明確かつ簡潔な言葉で記述します
Midjourneyがサポートする様々なパラメータを参照して画像スタイルを制御できます
不要な要素を除外するために、否定的な記述を適切に使用します
画像URLを参照として使用し、生成をガイドすることができます

画像生成フロー

Imagineタスクを送信し、初期画像を取得します
必要に応じて、Blend、Modalなどのタスクを通じてさらに最適化します
Actionアクションを実行して画像を微調整します
満足のいく結果画像をアップロードして保存します

画像形式の要件

サポートされている画像形式：
- JPEG/JPG
- PNG
- GIF (静止画)
- WEBP
画像サイズの制限：
- ファイルサイズ：最大 4MB
- 解像度：1024x1024以上を推奨
- 縦横比：1:1、2:3、3:2をサポート

パフォーマンス最適化の推奨事項

Base64エンコード：
- 標準のBase64エンコード形式を使用します
- 正しいMIMEタイププレフィックスを含めます
- データ転送を減らすために画像を圧縮します
タスク処理：
- webhookを使用してタスク完了通知を受信します
- 適切なリトライ戦略を設定します
- 非同期処理方式の使用を推奨します

エラー処理

リクエストのリトライメカニズムを実装します
エラーログの記録を追加します
適切なタイムアウト時間を設定します

Midjourney 画像フォーマット（Midjourney Proxy/Midjourney Proxy Plus）

目次