FLUX.1 Kontext [max]

flux_kontext_max

FLUX.1 Kontext [max] 为复杂创意任务提供最大上下文理解和图像生成能力。

调用地址

POST /v1/queue/flux_kontext_max # 创建任务

GET /v1/queue/flux_kontext_max/requests/{request_id}/status # 查询状态

GET /v1/queue/flux_kontext_max/requests/{request_id}/response # 获取结果

PUT /v1/queue/flux_kontext_max/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red apple on a white table, soft studio lighting.",
    "seed": 42,
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_upsampling": false,
    "safety_tolerance": 2
  }'

prompt string 必填

文本提示词，描述要生成或编辑图像内容

input_image string

第 1 张输入图像，支持 Base64 编码或 URL 格式

input_image_2 string

第 2 张输入图像，支持 Base64 编码或 URL 格式

input_image_3 string

第 3 张输入图像，支持 Base64 编码或 URL 格式

input_image_4 string

第 4 张输入图像，支持 Base64 编码或 URL 格式

seed int

随机种子，用于可重现生成结果，例如 42

aspect_ratio string

图像宽高比，格式如 16:9

范围：21:9 - 9:21

output_format string

输出格式。支持传入 jpeg，但返回文件可能仍为 png

可选值：jpeg、png

默认值：png

prompt_upsampling bool

是否启用提示词自动增强。如果激活，会自动修改提示词以实现更具创意生成

默认值：false

safety_tolerance int

输入和输出审核的容忍等级；0 最严格，6 最宽松

范围：0 <= x <= 6

默认值：2

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_max/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理