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

EvoLink Team
Product Team
2026年6月21日
7 分
コードから Midjourney V8.1 を使う場合、重要なのはエンドポイントだけではありません。タスクを作成し、状態を追跡し、コストを制御し、将来的に EvoLink 上の別の画像モデルも試せる形にしておくことが重要です。
EvoLink では、主な画像生成は
POST https://api.evolink.ai/v1/images/generations に model: "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'EvoLink で確認済みの仕様
| 項目 | 現在の仕様 |
|---|---|
| Endpoint | POST /v1/images/generations |
| Model | mj-v8.1 |
| Auth | Authorization: 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.1 | Midjourney V8.1 ルートを選択 |
prompt | はい | a product photo... --ar 16:9 | テキストと対応する MJ prompt パラメータ |
quality | いいえ | standard, hd | hd は 1.5x の quality 乗数 |
model_params.speed | いいえ | draft, fast | draft と hd は同時に使えません |
callback_url | いいえ | https://... | 完了イベント用の HTTPS コールバック |
quality を model_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.1、10.x.x.x、172.16-31.x.x、192.168.x.x などのプライベート IP 範囲は使えません。EvoLink はタスクが completed、failed、cancelled になったときにコールバックを送信します。タイムアウトは 10 秒、リトライは最大 3 回です。本番ハンドラはすぐに
2xx を返し、GET /v1/tasks/{task_id} で最終状態を確認し、重複コールバックをタスク ID と終端ステータスで重複排除し、30 日以内に結果 URL を自社ストレージへ保存します。コストとルーティング
| 選択 | 影響 | 推奨 |
|---|---|---|
fast | 標準速度 | 多くの 本番ワークフローのデフォルト |
draft | 軽量スケッチ。hd と併用不可 | 構図探索 |
standard | 基本品質 | プレビューと通常 UI 出力 |
hd | 1.5x の quality 乗数 | 最終アセットやキャンペーン |
EvoLink の価値は Midjourney V8.1 だけではありません。同じ認証、課金、非同期タスクパターンで Midjourney V7、Nano Banana Pro、GPT Image 2 などの画像ルートも比較できます。
本番チェックリスト
| 領域 | 必要な運用 |
|---|---|
| API Key | サーバー側のみに保存 |
| Logging | model、prompt hash、quality、model_params.speed、ユーザー ID、task_id を記録 |
| UI | pending, processing, completed, failed を表示 |
| Polling | 初期確認後はバックオフ |
| Callback | すぐ 2xx を返し、処理は非同期で継続 |
| Storage | 30 日以内に画像を保存 |
| コスト制御 | hd を明示的に制御 |
FAQ
EvoLink で Midjourney V8.1 はどの endpoint を使いますか?
Task 作成には
POST /v1/images/generations、状態確認には GET /v1/tasks/{task_id} を使います。正しいモデル名は何ですか?
主生成ルートの model name は
mj-v8.1 です。quality はどこに置きますか?
quality はトップレベルフィールドです。有効値は standard と hd です。model_params.speed の値は?
現在の docs では
draft、fast が定義されています。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 を使い、最後にタスクエンドポイントで確認するのが安全です。参考リンク
- EvoLink Midjourney V8.1 API ページ
- EvoLink Midjourney V8.1 画像生成ドキュメント
- EvoLink Midjourney V8.1 料金
- EvoLink モデルカタログ
EvoLink で Midjourney V8.1 を始める
まず Midjourney V8.1 playground で prompt を確認し、そのペイロード構造をバックエンドに移してください。
EvoLink で Midjourney V8.1 を開く

