mcpField
M
midjourney-image

midjourney-image

github.com/acedatacloudクリエイティブ・メディア1769 回インストール1 日前に更新
リポジトリ

midjourney-image について

Ace Data Cloud の API またはホスト型 MCP サーバー経由で Midjourney を使うスキルです。画像・動画の生成、画像編集、タスク追跡、認証情報の設定を扱います。

主な機能

  1. 01画像と動画の生成
  2. 02画像の編集と説明
  3. 03画像のブレンド
  4. 04生成タスクの追跡
  5. 05API 認証情報の設定

活用シーン

  1. 01プロンプトから画像を作成
  2. 02画像の編集や説明
  3. 03動画の生成や延長
  4. 04送信済みタスクの結果確認

MCP 対応

`https://midjourney.mcp.acedata.cloud/mcp` のホスト型 Streamable HTTP MCP サーバーに接続し、生成、編集、ブレンド、説明、動画、タスク取得のツールを利用できます。`mcp-midjourney` パッケージでローカルサーバーを実行する方法も記載されています。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/acedatacloud/skills --skill midjourney-image

インストール後、Claude Code で/midjourney-imageを入力して読み込まれたか確認します。

詳細

Ace Data Cloud 経由の Midjourney

Midjourney API またはホスト型 MCP サーバーを使用します。

初回セットアップ

  1. clawhub install @acedatacloud/midjourney で公式 Skill をインストールします。ClawHub の公開者が @acedatacloud であることを確認してください。
  2. AceDataCloud → Applications にサインインし、General application を開きます（プロンプトが表示された場合は初期化してください）。Midjourney の利用権限、残高、現在の料金を確認します。API キーをコピーするか、別のキーを作成する場合は Manage Keys → Create を選択します。Bearer を付けずにキーの値をコピーしてください。platform-... の管理トークンはサービス API キーではありません。
  3. Allowed APIs の制限を有効にする場合は、最初の画像生成に必要な /midjourney/imagine と /midjourney/tasks を含めてください。以下のその他の操作には、それぞれ個別のルートが必要です。
  4. OpenClaw Gateway ホストで、~/.openclaw/.env に ACEDATACLOUD_API_TOKEN=your_api_key_here を設定し、Gateway を再起動して新しいセッションを開始します。ターミナルから直接テストする場合は、そのシェルで export ACEDATACLOUD_API_TOKEN="your_api_key_here" を実行します。キーをプロンプトに記載したり、.env ファイルをコミットしたりしないでください。
  5. 以下の First image の例を実行します。返されたタスク ID を保存し、完了するまで同じタスクをクエリしてください。進行状況を確認するためだけに、課金対象の imagine リクエストを再送信しないでください。

トークンの設定とトラブルシューティング

最初の画像

生成を送信する前に、Ace Data Cloud コンソールで現在の Midjourney の料金と残高を確認してください。1 回の imagine リクエストで 2×2 のグリッドを生成できます。リクエストがすぐに task_id を返すように、async: true を使用します。

curl -X POST https://api.acedata.cloud/midjourney/imagine \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A small red sailboat on a calm lake at sunrise --ar 1:1","mode":"fast","async":true}'

返された task_id を保存します。進行状況を確認する際は同じ IDをポーリングしてください。imagine 呼び出しを繰り返さないでください。

curl -X POST https://api.acedata.cloud/midjourney/tasks \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action":"retrieve","id":"TASK_ID_FROM_FIRST_CALL"}'

タスクが受け付けられただけでは、画像は完成していません。取得したタスクに response.success: true と、使用可能な response.image_url または response.raw_image_url が含まれている場合にのみ、最終成果物を提示してください。タスクが失敗した場合は停止してエラーを報告してください。クエリまたはネットワーク接続が中断された場合もタスク ID を保持してください。同じ ID をクエリしても、新たな生成は送信されません。タスク API ガイドを参照してください。

その他の操作

  • 完了したグリッドは、image_id と upscale1、variation1、reroll などのアクションを指定して、POST /midjourney/imagine で変換できます。これらは新たな課金対象のアクションであり、タスクのクエリではありません。
  • POST /midjourney/edits で、プロンプトを指定して入力画像を編集します。
  • POST /midjourney/describe で画像を説明します。
  • POST /midjourney/videos で動画を生成または延長します。タスク ID を保存し、同じタスクをクエリしてください。
  • version パラメーターまたはプロンプトフラグは、稼働中の API に記載されているバージョンに限って使用してください。Midjourney V8.1 は fast と relax をサポートしていますが、turbo はサポートしておらず、quality パラメーターも受け付けません。

MCP ツール

ホスト型 Streamable HTTP サーバーは https://midjourney.mcp.acedata.cloud/mcp です。MCP クライアントで Authorization: Bearer <Ace token> を非公開で設定してください。名前付きツールには midjourney_imagine、midjourney_edit、midjourney_blend、midjourney_describe、midjourney_generate_video、midjourney_get_task、midjourney_get_tasks_batch があります。生成ツールから返された正確な ID を使って、最終的な成功または失敗が明らかになるまで midjourney_get_task を使用してください。MCP サーバーのソースに、すべてのツールの詳細が記載されています。

公開済みの mcp-midjourney パッケージを使って、サーバーをローカルで実行することもできます。操作に失敗した場合、代替モデルやサービスを追加しないでください。

トラブルシューティング

  • 401：トークンの値と有効期限を確認してください。403：Midjourney へのアクセス権またはコンテンツポリシーを確認してください。429：案内されたレート制限の間隔が過ぎるまでお待ちください。タスクの送信後に発生した 5xx またはトランスポートタイムアウトは、別のタスクを作成する理由にはなりません。まず保存済みの ID を照会してください。
  • タスクが完了しているのに URL がない場合は、タスクの応答全体を確認し、成果物が欠落していることを報告してください。タスク ID を結果として扱わないでください。
  • 完了した処理について、Ace Data Cloud の利用状況または請求記録を確認してください。タスクの照会によって、別の imagine リクエストが作成されることはありません。

コメント

Markdown 対応