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

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

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

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Upscale 後の単一画像に対して Zoom Out（アウトペイント）を実行します。元画像は保持され、外側に背景が補完されます。zoom_ratio < 2 は Outpaint（1.5×）、≥ 2 または未指定は CustomZoom（2×）で、いずれも直接画像を生成します。
項目内容
actionZOOM
課金midjourney@zoom[-speed]
必須task_id、または task_id + custom_id
任意zoom_ratio、index、speed、metadata

​
パラメータ

フィールド説明
task_id本プラットフォームが返したタスク ID（Upscale 後の単一画像タスクである必要があります）
custom_id任意。Zoom に対応する操作のボタン ID を直接指定
index任意。親タスクの何枚目か（1–4、既定 1）。単一画像では通常不要
zoom_ratio任意。自動マッチングする Zoom Out の段階（下表）
speedrelax / fast / turbo
metadata任意のメタデータ

​
自動マッチング

zoom_ratio一致するボタン
2 未満Zoom Out 1.5x
未指定または >= 2Zoom Out 2x

​
リクエスト例

{
  "task_id": "task_01KQW0D3WJ2QYJP9E3H7GZ4D2R",
  "zoom_ratio": 1.5,
  "speed": "fast"
}

​
注意

  • 親タスクは Upscale 後の単一画像かつ SUCCESS である必要があります。グリッドを渡すと This action requires an upscaled task... が返るので、先に upscale を呼び出してください。
  • Outpaint / CustomZoom はいずれも直接画像を生成し、mask は不要で、MODAL には入りません（MODAL を使うのは Inpaint のみ）。
  • 元タスクのバージョン metadata は自動継承されます。速度別の価格を分ける場合は midjourney@zoom-fast / midjourney@zoom-turbo を設定できます。

​
レスポンス

成功時は新しいローカルの task_id が返ります。結果は GET /v1/tasks/{task_id} をポーリングして取得してください。