パラメータ一覧
基本パラメータ
アスペクト比 --ar
画像のアスペクト比を設定します。整数比のみサポートされており、小数は拒否されます（1.39:1 ではなく 139:100 と書いてください）。極端な比率は実験的なもので、予測不能な結果を生む可能性があります。
1:1、4:3、3:2、16:9、9:16、2:3。ピクセルサイズは出力品質を参照してください。
カオス --chaos / --c
生成結果の多様性を制御します。値が高いほど、4 枚の画像間の差異が大きくなります。
スタイライズ --stylize / --s
写実性とアートスタイルのバランスを調整します。
実験パラメータ --exp
--stylize に似ていますが併用可能で、より詳細でダイナミックかつ創造的な画像を生成します。
- 推奨値：5、10、25、50、100
- 5-50 で効果の変化が顕著、50-100 では効果が頭打ちになります
- 25-50 を超えると
--stylizeと--pの効果を上書きする可能性があります。併用時は低めの値を使用してください
クオリティ --quality / --q
レンダリングの精細度を設定します。範囲 1 - 4、デフォルト 1。4 は高品質モードです。このパラメータはそのまま上流に透過され、価格は変わりません。
- V8.2 は
1/2/3/4を受け付けます。V8.1 は1/4のみ受け付けます。範囲外の値は拒否され、タスクは--qualityと許可される値を示すパラメータエラーで失敗し、予約されたクレジットは返金されます - 値が高いほどレンダリングに時間がかかります
- 画像生成エンドポイント専用。派生タスク（バリエーション、リミックス、編集など）はソース画像を継承します
Raw モード --raw
デフォルトの美化を無効化し、プロンプトの細部により厳密に従います。フォトリアリズムや精密な制御が必要なシーンに適しています。
ネガティブプロンプト --no
画像に含めたくない要素を列挙します。複数の項目はカンマで区切ります。これは、それらの要素に -0.5 のウェイトを与えるのと同等です。説明文に「no fruit」や「without fruit」と書いても効果はありません。Midjourney はそれらの語を内容として扱うため、代わりにこのパラメータを使用してください。
シード --seed
比較テストのために初期のランダム状態を固定します。
- 範囲：0 - 4294967295
- シードは初期状態を固定するだけで、同一の出力を保証するものではありません。プロンプト、パラメータ、モデルバージョンのいずれかを変更すると結果は変わります
- テスト時は固定シードを、本番では多様性のためにランダムなシードを使用してください
画像参照パラメータ
画像プロンプト
プロンプトの先頭に画像 URL を配置し、生成内容に影響を与えます。- 画像プロンプトは最大 20 枚
- 対応フォーマット：
.png、.gif、.webp、.jpg、.jpeg。1 ファイルあたり最大 20 MB、1 辺あたり最大 16k ピクセル - 画像のみのプロンプト（テキストなし）は
--stylizeおよび--weirdと互換性がありません draft速度でも利用できます（本プラットフォームで検証済み）。draftと併用できないのは--tileのみです- URL は数秒以内に公開アクセスできる必要があります。入力画像の要件を参照してください
画像ウェイト --iw
画像プロンプトの結果への影響度を制御します。範囲 0 - 3、デフォルト 1。値が高いほど参照画像に近い結果になります。
スタイル参照 --sref
参照画像のビジュアルスタイル（色、テクスチャ、ライティング）を一致させ、内容はコピーしません。テキストプロンプトと併用する必要があります。
- 複数指定をサポート：
--sref URL1 URL2。相対ウェイトは--sref URL1::2 URL2::1の形で指定できます（上流のドキュメントに記載。本プラットフォームでは未検証） - ランダムスタイルをサポート：
--sref random（生成後に数値コードを返し、再利用可能） - sref は最大 20 個
- テキストプロンプトは指示ではなく内容を記述してください（「make this look like the reference」ではなく「a cat」）
スタイルウェイト --sw
スタイル参照の影響度を制御します。範囲 0 - 1000、デフォルト 100。
パーソナライゼーション --p
--p はそのまま上流に透過されます。受け付けるのは、上流チャネルが本プラットフォームの組織アカウント下で作成したムードボード id です。本プラットフォームではムードボードの作成・一覧取得エンドポイントをまだ公開しておらず、midjourney.com の個人用プロファイルコードは使用できません。スタイルを揃えたい場合は代わりに --sref / --sw と --seed を使用してください。--p は --weird と併用できません。
速度モード
速度モードは API のmodel_params.speed フィールドで制御します（プロンプトに --draft / --fast を書かないでください）。
ルートごとの取りうる値：画像生成は draft / fast、リミックス・キャンバス編集・リテクスチャ・アップロードペイントは fast のみ、バリエーションと背景除去には speed フィールドがありません（バリエーションでは speed: fast は受け付けられて無視され、それ以外の値は 400 を返します）。
V7 とは異なり、V8.2 の
draft モードは半額になりません——fast と同じ倍率を使用します。draft は 1 回の実行で 24 枚の小さなスケッチを返すので、気に入ったものを選んでフル品質で再実行してください。draft は hd 品質または --tile と組み合わせることはできません（--oref は V8.2 ではそもそもサポートされていません）。V8.2 では turbo は利用できません。 上流チャネルのドキュメントでは V8 は turbo モード非対応とされているため、speed: "turbo" は V8.2 のすべてのエンドポイントで 400 で拒否されます（V8.1 と同様）。出力品質
出力解像度はトップレベルのquality パラメータで制御し、プロンプトのパラメータではありません。プロンプトに --hd を書かないでください。
- 品質倍率は速度倍率と掛け合わされます（乗算）
hdはdraft速度と互換性がありません- V8.2 には独立したアップスケールエンドポイントがありません。上流は V8 の「アップスケール」を
hdでの新規生成として実装しているため、2K 出力が必要な場合はquality: "hd"を使用してください
プロンプトの文字数制限
説明文が長すぎる場合は拒否され、タスクはパラメータエラー（
invalid_parameters）で失敗し、予約されたクレジットは返金されます。
依存関係
以下のパラメータは効果を発揮するために他のパラメータを必要とします：競合関係
V8.2 でサポートされていないパラメータ
V8.2 が除去するのは、バージョン固定や課金を狂わせるパラメータだけです。それ以外のパラメータはすべてそのまま上流に透過されます。上流がパラメータをサポートしていない場合、タスクはパラメータエラー（invalid_parameters）で失敗し、予約されたクレジットは返金されます。黙って破棄されることはありません。
上流チャネルは V8.1 / V8.2 向けに指示ベースの編集エンドポイント（Midjourney Edit Model：
--edit、最大 4 枚の参照画像、任意で透明マスクによる再描画）も公開しています。本プラットフォームではまだ公開されておらず、提供時期を調整中です。mj-v8.2-edit と mj-v8.2-upload-paint はキャンバス編集（canvas + img_pos + 任意の mask）であり、mj-v8.2-retexture はリテクスチャツールです。現在のいずれのエンドポイントでも、プロンプトに --edit を書くと上流で拒否されます。入力画像の要件
以下のルールは、画像プロンプト、--sref の URL、および retexture / upload-paint / remove-bg の image_urls フィールドに適用されます。
- 公開 HTTP(S) URL のみ。 Base64 と data URL は受け付けません。URL 自体は 1024 文字以内である必要があります。
- 上流はタスク作成時に画像を同期的に取得し、約 10 秒で諦めます（本プラットフォームでの実測値）。時間内にファイルをダウンロードできない場合、リクエストは
400で失敗し、タスクは作成されません。中国本土外の画像ホスティング（imgur、ibb、raw.githubusercontent、pinimg、picsum など）は実際にはほぼ毎回失敗します。画像を高速な CDN に置くか、先にファイルアップロード APIでアップロードして、返された URL を使用してください。 - 対応フォーマット：
.png、.gif、.webp、.jpg、.jpeg（mj-v8.2-remove-bgは.png、.jpg、.jpegのみ受け付けます）。1 ファイルあたり最大 20 MB、1 辺あたり最大 16k ピクセル。非常に大きなファイルは、到達可能なホストからでも取得時間の予算を超えることがあります。 mj-v8.2-remove-bgは、本プラットフォームの Midjourney タスクが返す署名付き結果リンク（Expires/Signatureを含む URL）を受け付けません。画像を再ホストするか、署名なしの URL を使用してください。retexture と upload-paint はこれらのリンクを受け付けます。- 画像プロンプトと
--srefの URL はdraft速度でも受け付けられます（本プラットフォームで検証済み）。draftと併用して拒否されるのは--tileのみです。
プロンプトのフォーマット規則
基本構造
記述ルール
- パラメータはテキストプロンプトの末尾に置きます
--の前にはスペースが必要です- パラメータに句読点を使用しないでください
- パラメータの後にテキストを続けることはできません
- 画像内に文字を描画するには、二重引用符で囲みます：
a neon sign that says "OPEN" --ar 3:2
例
タスクのワークフロー
V8.2 の 7 つのモデルはすべて非同期で、呼び出しごとに課金されます。- 送信 —
POST /v1/images/generationsは即座にタスクid、status: processing、usage.credits_reservedを返します。上流のジョブはバックグラウンドで作成されます。 - ポーリング —
GET /v1/tasks/{task_id}（タスクステータスの照会）。上流の報告では生成と編集の平均所要時間は約 40 秒です。3〜5 秒ごとにポーリングし、クライアント側で約 20 分の上限を設けてください。タスクがまだprocessingの間に同じプロンプトを再送信しないでください。上流は組織アカウントごとに同時実行数を制限しており、上限を超えた場合は本プラットフォームが自動的にバックオフして再投入します。利用者側では失敗ではなく、タスクの所要時間が長くなるという形で現れます。 - 結果の読み取り —
statusがcompletedになると、resultsに画像 URL が格納されます。fastでは 4 枚、draftでは 24 枚です。usage.costに最終的な課金額が表示されます。 - 画像の保存 — 結果リンクは署名付き OSS URL で、有効期間は 30 日です。署名は
GETにのみ有効なため、HEADで死活確認すると403が返ります。保持したいものはダウンロードするか再ホストしてください。 - 任意のコールバック —
callback_url（HTTPS、公開ホスト）を渡すと、completed/failed時に通知されます。コールバックはバックオフ付きで 3 回リトライされます。あくまで補助的な通知として扱い、タスク照会で確認してください。
失敗したタスクは、作成時に拒否されたリクエスト、上流によるパラメータ拒否（
--oref、範囲外の --q、長すぎる説明文）、画像取得の失敗、そして上流のコンテンツ審査でタスクのすべての画像がブロックされた場合を含めて全額返金されます。1 枚でも審査を通過した画像があれば、タスクは completed となり通常どおり課金されます。エラーコードとリトライの指針はエラーコードリファレンスページに記載されています。
派生タスク
バリエーション、リミックス、キャンバス編集は、同一アカウントの完了済みmj-v8.2 シリーズのタスクをソース（task_id + image_number）として使用します。上流チャネルのドキュメントに記載され、本プラットフォームで検証済みのルール：
- これらの派生操作では、ソースタスクは上流の Midjourney V7 エンジンでレンダリングされるため、結果はソース画像とスタイルがわずかに異なる場合があります。価格は変わりません。V8.1 のソースは受け付けられません。
image_numberでソース画像を選択します：fastのソースタスクは0〜3、draftのソースタスクは0〜23（24 枚のスケッチすべてをバリエーション、リミックス、編集のソースにできます）。mj-v8.2-upload-paint、mj-v8.2-retexture、mj-v8.2-remove-bgの結果は、バリエーション、リミックス、編集のソースとして使用できません。上流はこれらのアップスケールのみを許可しており、本ルートでは公開していません。代わりに画像生成、バリエーション、リミックス、編集のタスクをソースにしてください。
よくある質問
V8.1 から移行する際にプロンプトを変更する必要はありますか？ いいえ。model の値を変更するだけで、プロンプト、model_params、価格は変わりません。--oref / --ow が使えなくなる点と、--q が 1 と 4 に加えて 2 と 3 を受け付けるようになる点だけが異なります。
画像プロンプトがタスク作成前に 400 で失敗するのはなぜですか？
上流が取得時間の予算内に画像をダウンロードできなかったためです。ファイルを高速で公開アクセス可能なホストに移すか、ファイルアップロード API を使用してから再試行してください。
turbo 速度はありますか？
いいえ。上流のドキュメントでは V8 は turbo 非対応とされているため、V8.2 は V8.1 と同様に draft と fast のみ提供します。
--q 4 は遅くなったり高くなったりしますか？
課金は変わりません。上流は 4 を高品質モードとしており、レンダリングに時間がかかります。
V8.2 の画像をアップスケールできますか？
V8.2 にはアップスケールエンドポイントがありません。代わりに quality: "hd" で生成し、ネイティブ 2K 出力を取得してください。
コンテンツ審査に関する注意
Midjourneyにはコンテンツ審査機能が組み込まれています。審査は画像ごとに個別に行われます。生成された画像の一部がフィルタリングされた場合、タスクは
completed のままで、残りの画像は通常どおり配信され、通常どおり課金されます。すべての画像がフィルタリングされた場合、タスクは failed となり、予約されたクレジットは全額返金されます。プロンプトの内容がガイドラインに準拠しているかご確認ください。