メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
blend
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/blend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/a.png",
      "https://example.com/b.png"
    ],
    "dimensions": "SQUARE",
    "speed": "fast"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/blend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "image_urls": [
      "https://example.com/a.png",
      "https://example.com/b.png"
    ],
    "dimensions": "SQUARE",
    "speed": "fast"
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
2〜4 枚の画像を 1 枚の新しい画像に融合します（MJ 定番の blend 機能）。画像のみで融合し、prompt は使用できません。
項目内容
actionBLEND
課金midjourney@blend[-speed]
必須image_urls（2〜4 枚）

​
パラメータ

フィールド型必須既定説明
image_urlsstring[]はい—参照画像、2〜4 枚。自動で base64 に変換。1 枚 ≤ 12 MiB
dimensionsstringいいえSQUARE3 段階のアスペクト比：SQUARE(1:1) / PORTRAIT(2:3) / LANDSCAPE(3:2)。size 指定時は上書きされる
sizestringいいえ—自由なアスペクト比。任意の w:h（例 "16:9"、"9:16"、"21:9"）。dimensions より優先され、画面比率として適用される
speedstringいいえrelaxrelax / fast / turbo
metadataobjectいいえ—カスタムメタデータ

​
リクエスト例

3 段階比率（dimensions）： 
{
  "image_urls": [
    "https://example.com/a.png",
    "https://example.com/b.png"
  ],
  "dimensions": "SQUARE",
  "speed": "fast"
}
自由比率（size）： 
{
  "image_urls": [
    "https://example.com/a.png",
    "https://example.com/b.png"
  ],
  "size": "16:9",
  "speed": "fast"
}
最終的な prompt の末尾に --ar 16:9 が付きます。

​
注意

  • アスペクト比の優先順位：size（自由） > dimensions（3 段階） > 既定 SQUARE。
  • image_urls が 2 枚未満または 4 枚超過の場合は 400 を返します。
  • blend には独立したバージョンパラメータはありません。速度別に価格を分ける場合は midjourney@blend-fast / midjourney@blend-turbo を設定できます。