Midjourney プロキシ
Midjourney Proxy 形式で Midjourney を呼び出します。送信系のエンドポイントはすべて POST(照会系を除く)で、認証は他のエンドポイントと同じです。
ワークフロー
- タスクを送信(
/mj/submit/*)→ タスク ID を取得。 - ポーリング(
/mj/task/{id}/fetch)→statusとimageUrlを取得。 - 必要に応じて 4 枚グリッドの結果を upscale / vary / reroll(
/mj/submit/changeまたは/mj/submit/action)。
Imagine
POST /mj/submit/imaginecurl https://test.kailin.com.cn/mj/submit/imagine \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-token" \
-d '{ "prompt": "a cyberpunk cat, neon light --ar 16:9" }'
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
prompt | string | はい | 描画プロンプト。MJ のフラグを指定可(--ar、--v、…) |
base64Array | array | いいえ | 参照画像(Base64 の配列) |
notifyHook | string | いいえ | コールバック URL(ポーリングでも可) |
state | string | いいえ | カスタムパススルーフィールド |
レスポンス:
{ "code": 1, "description": "Submitted", "result": "1792xxxx-task-id" }
code: 1 は成功で、result がタスク ID。code: 21 はタスクに /mj/submit/modal での確認が必要、code: 22 は重複タスク、code: 9 はキュー待ち(result に通知が入る)を意味します。
タスクの照会
GET /mj/task/{id}/fetchcurl https://test.kailin.com.cn/mj/task/1792xxxx-task-id/fetch \
-H "Authorization: Bearer sk-your-token"
{
"id": "1792xxxx-task-id",
"action": "IMAGINE",
"status": "SUCCESS",
"progress": "100%",
"imageUrl": "https://cdn.example.com/mj/xxx.png",
"prompt": "a cyberpunk cat, neon light --ar 16:9",
"submitTime": 1730000000000,
"finishTime": 1730000600000
}
| フィールド | 説明 |
|---|---|
status | NOT_START / SUBMITTED / IN_PROGRESS / SUCCESS / FAILURE / CANCEL |
imageUrl | 結果画像の URL(SUCCESS になってから返る) |
failReason | 失敗理由(FAILURE の場合) |
一括照会
POST /mj/task/list-by-condition{ "ids": ["id1", "id2"] }
後続アクション
Upscale / Variation / Reroll
POST /mj/submit/change{ "taskId": "1792xxxx-task-id", "action": "UPSCALE", "index": 2 }
| パラメーター | 説明 |
|---|---|
action | UPSCALE / VARIATION / REROLL / HIGH_VARIATION / LOW_VARIATION / ZOOM など |
index | グリッド位置 1–4(UPSCALE / VARIATION では必須) |
customId | 代わりに、タスクが返すボタンの customId を渡すこともできます |
ボタンアクション
POST /mj/submit/actionタスクが返した buttons のいずれか(U/V ボタン、Regional、Pan など)をクリックします:
{ "taskId": "1792xxxx-task-id", "customId": "MJ::JOB::upsample::3::uuid" }
その他の送信エンドポイント
| エンドポイント | 説明 |
|---|---|
POST /mj/submit/blend | 2–4 枚の画像をブレンド(base64Array、任意の dimensions) |
POST /mj/submit/describe | 画像からプロンプトを生成(base64 を送信、4 つの候補プロンプトを返す) |
POST /mj/submit/modal | code: 21 のタスクを確認(taskId + prompt) |
POST /mj/submit/shorten | プロンプトの分析と短縮 |
POST /mj/submit/simple-change | クイック変更:"taskId U2" のような content |
POST /mj/submit/edits | 部分的な編集 |
POST /mj/submit/video | 動画生成 |
POST /mj/submit/upload-discord-images | 画像をアップロードして参照 URL を取得 |
POST /mj/insight-face/swap | 顔交換(InsightFace) |
ヘルパーエンドポイント
| エンドポイント | 説明 |
|---|---|
GET /mj/task/{id}/image-seed | タスクの画像シードを 取得 |
GET /mj/image/{id} | プロキシ経由の画像アクセス |
ヒント
code: 21 を返す送信は、実行前に必ず /mj/submit/modal で確認する必要があります — クローズアップの人物画などのシーンでよく発生します。