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

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

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

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
Imagine の四分割グリッドのいずれか 1 枚に対して弱いバリエーション（varySubtle、V1–V4 相当）を実行します。強いバリエーションは High Variation を参照してください。
項目内容
actionVARIATION
課金midjourney@variation[-speed]
必須task_id + index、または task_id + custom_id
任意speed、metadata

​
パラメータ

フィールド説明
task_id本プラットフォームが返した元タスク ID（SUCCESS であること）
index1〜4（V1〜V4 に対応）。custom_id とどちらか一方
custom_id対応する操作のボタン ID を直接指定します。指定した場合、index による自動マッチングは行いません
speedrelax / fast / turbo
metadataカスタムメタデータ

​
リクエスト例

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "index": 3,
  "speed": "turbo"
}

​
レスポンス

送信で新しいローカルの task_id を返します。GET /v1/tasks/{task_id} をポーリングし、SUCCESS 時にバリエーションの新しい四分割 grid_image_url と 4 枚の image_urls を含みます： 
{
  "id": "task_xxx",
  "status": "SUCCESS",
  "action": "VARIATION",
  "grid_image_url": "...",
  "image_urls": ["...", "...", "...", "..."]
}
元タスクの version / niji は自動継承されます（課金フォールバックに影響）。速度別の価格を分ける場合は midjourney@variation-fast / midjourney@variation-turbo を設定できます。

​
注意

  • 親タスクは SUCCESS 状態である必要があり、そうでない場合は 400（task is not in SUCCESS state）を返します。
  • index は 1〜4 である必要があります。custom_id と index はどちらか一方です。
  • 既定は varySubtle（弱いバリエーション）。強いバリエーションは High Variation を、Low Variation は同じ action で課金キーのみ異なり挙動は同一です。