GLM-5.2 提供開始詳しく見る
EvoLink で Midjourney V8.1 API を使う方法:ペイロード、ポーリング、コールバック
guide

EvoLink で Midjourney V8.1 API を使う方法:ペイロード、ポーリング、コールバック

EvoLink Team
EvoLink Team
Product Team
2026年6月21日
7 分

コードから Midjourney V8.1 を使う場合、重要なのはエンドポイントだけではありません。タスクを作成し、状態を追跡し、コストを制御し、将来的に EvoLink 上の別の画像モデルも試せる形にしておくことが重要です。

EvoLink では、主な画像生成は POST https://api.evolink.ai/v1/images/generationsmodel: "mj-v8.1" を渡して行います。レスポンスは非同期タスクです。状態確認には GET https://api.evolink.ai/v1/tasks/{task_id}、本番では callback_url も使えます。

クイック回答

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "mj-v8.1",
    "prompt": "a premium product photo of a matte black espresso machine on a marble counter --ar 16:9 --s 250",
    "quality": "standard",
    "model_params": {
      "speed": "fast"
    },
    "callback_url": "https://your-domain.com/webhooks/evolink-image-task"
  }'
返ってきた id を保存してください。これがポーリング、コールバック照合、エラー調査で使う task_id です。
curl --request GET \
  --url https://api.evolink.ai/v1/tasks/<task_id> \
  --header 'Authorization: Bearer YOUR_API_KEY'
項目現在の仕様
EndpointPOST /v1/images/generations
Modelmj-v8.1
AuthAuthorization: Bearer YOUR_API_KEY
必須フィールドmodel, prompt
品質top-level quality: standard または hd
速度model_params.speed: draft, fast
非同期ステータスGET /v1/tasks/{task_id}
出力Fast は最大 4 枚、Draft は最大 24 枚の軽量 0.5K sketch
リンク有効期限生成画像 URL は 30 日間有効

リクエストフィールド

フィールド必須注意
modelはいmj-v8.1Midjourney V8.1 ルートを選択
promptはいa product photo... --ar 16:9テキストと対応する MJ prompt パラメータ
qualityいいえstandard, hdhd は 1.5x の quality 乗数
model_params.speedいいえdraft, fastdrafthd は同時に使えません
callback_urlいいえhttps://...完了イベント用の HTTPS コールバック
qualitymodel_params の中に入れないでください。この EvoLink ルートではトップレベルフィールドです。

Text-to-image と image-to-image

Text-to-image の例:

{
  "model": "mj-v8.1",
  "prompt": "a cinematic product photo of a titanium travel mug on wet black stone --ar 16:9 --s 250",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}
Image-to-image では、画像 URL を prompt の先頭に置きます。対応形式は PNG、GIF、WebP、JPG、JPEG です。画像 URL 1 つだけでテキストがない リクエストは無効です。1 枚の画像+テキスト、複数画像、または複数画像+テキストを使ってください。
{
  "model": "mj-v8.1",
  "prompt": "https://your-cdn.example.com/reference-sofa.jpg a luxury living room campaign image --ar 4:3 --iw 1.2",
  "quality": "standard",
  "model_params": {
    "speed": "fast"
  }
}

本番コールバック

callback_url は HTTPS である必要があります。長さは 2048 文字以内で、127.0.0.110.x.x.x172.16-31.x.x192.168.x.x などのプライベート IP 範囲は使えません。EvoLink はタスクが completed、failed、cancelled になったときにコールバックを送信します。タイムアウトは 10 秒、リトライは最大 3 回です。
本番ハンドラはすぐに 2xx を返し、GET /v1/tasks/{task_id} で最終状態を確認し、重複コールバックをタスク ID と終端ステータスで重複排除し、30 日以内に結果 URL を自社ストレージへ保存します。

コストとルーティング

選択影響推奨
fast標準速度多くの 本番ワークフローのデフォルト
draft軽量スケッチ。hd と併用不可構図探索
standard基本品質プレビューと通常 UI 出力
hd1.5x の quality 乗数最終アセットやキャンペーン

EvoLink の価値は Midjourney V8.1 だけではありません。同じ認証、課金、非同期タスクパターンで Midjourney V7、Nano Banana Pro、GPT Image 2 などの画像ルートも比較できます。

本番チェックリスト

領域必要な運用
API Keyサーバー側のみに保存
Loggingmodel、prompt hash、qualitymodel_params.speed、ユーザー ID、task_id を記録
UIpending, processing, completed, failed を表示
Polling初期確認後はバックオフ
Callbackすぐ 2xx を返し、処理は非同期で継続
Storage30 日以内に画像を保存
コスト制御hd を明示的に制御

FAQ

Task 作成には POST /v1/images/generations、状態確認には GET /v1/tasks/{task_id} を使います。

正しいモデル名は何ですか?

主生成ルートの model name は mj-v8.1 です。

quality はどこに置きますか?

quality はトップレベルフィールドです。有効値は standardhd です。

model_params.speed の値は?

現在の docs では draftfast が定義されています。

quality: "hd"speed: "draft" は併用できますか?

できません。EvoLink docs では quality: "hd"model_params.speed: "draft" は同時指定不可です。

Image-to-image は使えますか?

使えます。画像 URL を prompt の先頭に置き、画像が 1 枚だけの場合はテキスト説明も追加します。

生成画像 URL はどのくらい有効ですか?

生成画像 URL は 30 日間有効です。自社ストレージに保存してください。

Polling と callback のどちらを使うべきですか?

テストや内部ツールは polling で十分です。本番ワークフローでは callback_url を使い、最後にタスクエンドポイントで確認するのが安全です。

参考リンク

まず Midjourney V8.1 playground で prompt を確認し、そのペイロード構造をバックエンドに移してください。
EvoLink で Midjourney V8.1 を開く

AIコストを89%削減する準備はできましたか?

今すぐEvoLinkを始めて、インテリジェントなAPIルーティングの力を体験してください。