メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
upscale
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/upscale \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "index": 1,
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
親タスクの四分割（grid_image_url）から U1–U4 のいずれか 1 枚を選び、単一画像を得ます。既存の 4 枚から切り出す方式で実装されており、ローカル合成で通常は即時に返ります。
項目内容
actionUPSCALE
課金midjourney@upscale[-version][-speed]
必須task_id + index、または task_id + custom_id
任意speed、metadata

​
パラメータ

フィールド型説明
task_idstring親タスク ID（imagine / variation / reroll などの SUCCESS タスクであること）
indexintどの 1 枚か（U1–U4）、範囲 1–4。custom_id とどちらか一方
custom_idstring対応する操作のボタン ID を直接渡す。index とどちらか一方。指定時は index マッチングをスキップ
speedstringrelax / fast / turbo（ローカル合成のため影響なし）
metadataobjectカスタムメタデータ

​
リクエスト例

index で選択： 
{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 1,
  "speed": "fast"
}
ボタンを直接渡す場合： 
{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample::1::xxxx"
}

​
レスポンス

送信で新しい task_id を返し、通常ミリ秒単位で SUCCESS になります。SUCCESS 時 image_urls は 1 要素（単一画像）のみで、buttons に継続操作（zoom / inpaint / pan / variation など）が含まれます。

​
注意

  • 親タスクは SUCCESS 状態である必要があり、そうでない場合は 400（task is not in SUCCESS state）を返します。
  • index は 1–4 である必要があり、範囲外は 400。custom_id と index はどちらか一方で、両方指定時は custom_id が優先されます。
  • リソースを消費するのは imagine 段階で、upscale は既存画像から選ぶだけのため、ほぼ失敗しません。
  • upscale 後の単一画像は Zoom / Inpaint / Variation で継続できます。

​
HD upscale（高精細アップスケール、2x 単一画像を出力）

通常の upscale はローカル合成——親タスクが既に持つ 4 枚から 1 枚を切り出して即時に返します。後続で単一画像に対し zoom / inpaint などの精密な操作を行う場合は、HD upscale の利用を推奨します。実際の拡大処理を実行し、2x 高精細の単一画像を出力し、約 60–120s で完了します。生成された単一画像は後続の zoom / inpaint をより安定してサポートできます。 HD upscale は custom_id で拡大コマンドを指定し、imagine のバージョンごとに異なるコマンドに対応します：
customId コマンド適用バージョン
upsample_v5_2xv5 imagine
upsample_v5_4xv5 imagine
upsample_v6_2x_subtlev6 / v6.1 imagine
upsample_v6_2x_creativev6 / v6.1 imagine
upsample_v7_2x_subtlev7 / v8.1 imagine
upsample_v7_2x_creativev7 / v8.1 imagine

​
HD upscale 例

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "custom_id": "MJ::JOB::upsample_v7_2x_subtle::1::xxxx"
}
完了すると本物の 2x 高精細単一画像タスクが得られ、それに対して引き続き zoom / inpaint を行えます。

​
通常の upscale との比較

観点通常の upscaleHD upscale
実装ローカル合成（切り出し）実際の拡大処理
所要時間ミリ秒単位約 60–120s
出力4 枚から第 N 枚を取得2x 高精細単一画像
後続zoom / inpaint / variationzoom / inpaint がより安定

​
⚠️ pan は依然として利用不可

HD upscale が出力した高精細単一画像であっても、pan 操作は依然として拒否されます（「無効な生成リクエスト」を返します）——これは pan 操作そのものに対する Midjourney の制限であり、拡大方式とは無関係です。詳しくは Pan を参照してください。