メインコンテンツへスキップ
POST
/
v1
/
midjourney
/
generations
/
reroll
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/reroll \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
curl --request POST \
  --url https://api.apimart.ai/v1/midjourney/generations/reroll \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
    "speed": "fast"
  }'
{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KV52C0TEJSYZMCG0NCS4YWKK"
    }
  ]
}
元タスクの prompt から 4 枚を再抽選します(🔄 ボタン相当)。グリッド全体を再抽選するため、index は不要です
項目内容
actionREROLL
課金midjourney@reroll[-speed]
必須task_id、または task_id + custom_id
任意speedmetadata

パラメータ

フィールド説明
task_id本プラットフォームが返した元タスク ID
custom_id任意。reroll に対応する操作のボタン ID を直接指定
speedrelax / fast / turbo
metadata任意のメタデータ

自動マッチング

サービスは元タスクの buttons から ::reroll:: を含むボタン、または reroll 絵文字に一致するボタンを探します。

リクエスト例

{
  "task_id": "task_01KQVZAPBW13W63DQNQZT7FCQK",
  "speed": "fast"
}

エラーレスポンス

HTTPcodedescription
4004task_id is required for reroll
4004task ... is not in SUCCESS state
4043task ... not found
5029サービス拒否

レスポンス

送信で新しいローカルの task_id を返します。GET /v1/tasks/{task_id} をポーリングし、SUCCESS 時に同じ prompt の新しい四分割グリッドが得られます。 元タスクの prompt / version / niji / 構造化パラメータは自動継承されます(シードが異なる場合があるため結果は変わります)。速度別の価格を分ける場合は midjourney@reroll-fast / midjourney@reroll-turbo を設定できます。

注意

  • reroll できるのは imagine グリッド、または reroll 自身が生成したグリッドのみです。upscale / variation / pan などの二次操作を経たタスクは reroll できません
  • 親タスクは SUCCESS 状態である必要があります。