FLUX 图像

请求体是平铺的 JSON，创作字段与输出字段都在顶层，没有 content 数组包装。

The body is flat JSON: creative fields and output fields sit at the top level, with no content array wrapper.

参考图按顺序编号为 ref_image_0、ref_image_1，提示词里也可以写成 Image 1、Image 2。

Reference images are numbered in order as ref_image_0, ref_image_1, and can also be referred to in the prompt as Image 1, Image 2.

width、height、像素形式的 size（如 1024x1024）、seed、steps、guidance、output_format、negative_prompt、prompt_upsampling、mask_url 都会被拒绝并返回 400，不会静默忽略。

输出尺寸用 resolution 控制，形状用 aspect_ratio 控制。

width, height, pixel-form size (such as 1024x1024), seed, steps, guidance, output_format, negative_prompt, prompt_upsampling, and mask_url are all rejected with a 400 rather than silently ignored.

Control output dimensions with resolution and shape with aspect_ratio.

bbox 是提示词字符串的一部分，不是独立参数。每个元素用 id、from、src_bbox、tgt_bbox、desc 描述。

坐标格式是 [top, left, bottom, right]，即 [y1, x1, y2, x2]，归一化到 0 到 1000，原点在左上角，不是像素值。

需要保留的区域也要写进 bbox，并在 desc 里说明保持不变。

bbox is part of the prompt string, not a separate parameter. Each element is described by id, from, src_bbox, tgt_bbox, and desc.

Coordinates are [top, left, bottom, right], i.e. [y1, x1, y2, x2], normalized to 0–1000 with the origin at the top left — not pixel values.

Regions to preserve must also be written into the bbox, with desc explaining that they stay unchanged.

flux-kontext-pro 与 flux-kontext-max 支持 output_format、response_format、seed、prompt_upsampling、safety_tolerance（0 到 6），但不支持 resolution，输出固定在约 1MP。size 写像素时只会映射到最接近的支持比例，不保证精确尺寸。

flux-kontext-pro and flux-kontext-max support output_format, response_format, seed, prompt_upsampling, and safety_tolerance (0 to 6), but not resolution; output is fixed at about 1MP. A pixel size only maps to the nearest supported ratio and doesn't guarantee exact dimensions.

提交成功返回受理结构：

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

完成态返回：

{
  "code": 200,
  "data": {
    "id": "task_01K8SGYNNNVBQTXNR4MM964S7K",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        { "url": ["https://cdn.oairoute.com/f/image/task_01K8_0.png"], "expires_at": 1763174708 }
      ]
    },
    "created": 1763088289,
    "completed": 1763088302
  }
}

A successful submission returns an accepted structure:

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

The completed state returns:

{
  "code": 200,
  "data": {
    "id": "task_01K8SGYNNNVBQTXNR4MM964S7K",
    "status": "completed",
    "progress": 100,
    "result": {
      "images": [
        { "url": ["https://cdn.oairoute.com/f/image/task_01K8_0.png"], "expires_at": 1763174708 }
      ]
    },
    "created": 1763088289,
    "completed": 1763088302
  }
}

更多状态码与重试建议见错误码与限流，常见报错的排查步骤见常见问题。

For more status codes and retry guidance see Error codes and rate limits; for troubleshooting steps on common errors see the FAQ.

flux-kontext 系列走同一路径但参数不同，见下方差异说明。

The flux-kontext series uses the same path with different parameters; see the differences above.