FLUX.1 Kontext [pro]

flux_kontext_pro

FLUX.1 Kontext [pro] 提供上下文感知图像生成，具有专业功能和增强的复杂提示理解能力。

调用地址

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

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

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

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

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro" \
  --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

作为参考使用的 Base64 编码图像或图像的 URL。支持高达 20MB

input_image_2 string

作为参考使用的 Base64 编码图像或图像的 URL。支持高达 20MB

input_image_3 string

作为参考使用的 Base64 编码图像或图像的 URL。支持高达 20MB

input_image_4 string

作为参考使用的 Base64 编码图像或图像的 URL。支持高达 20MB

seed int

用于可重复性。如果为 null 或省略，则使用随机种子。接受任何整数，例如 42

aspect_ratio string

图像的长宽比，介于 21:9 和 9:21 之间

output_format string

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

可选值：jpeg、png

默认值：png

prompt_upsampling bool

是否对提示进行上采样。如果激活，会自动修改提示词以实现更具创意的生成

默认值：false

safety_tolerance any

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

范围：0 <= x <= 6

默认值：2

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/flux_kontext_pro/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	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理