跳转到主要内容
POST
/
generate
/
k
/
flux-kontext
Flux Kontext 图片生成/编辑
curl --request POST \
  --url https://api.sinancode.com/v1/generate/k/flux-kontext \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "a beautiful landscape with mountains",
  "aspect_ratio": "16:9",
  "enable_translation": true,
  "input_image": "https://example.com/input.jpg",
  "model": "flux-kontext-pro",
  "output_format": "jpeg",
  "prompt_upsampling": false,
  "safety_tolerance": 2,
  "upload_cn": false,
  "watermark": ""
}
'
{
  "task_id": "01234567-89ab-cdef-0123-456789abcdef"
}
使用 Black Forest Labs 的 FLUX.1 Kontext 模型进行上下文感知的图像生成与编辑。 模型特点：
  • 上下文理解 - 通过文本指令直接修改现有图像，无需复杂工作流
  • 角色一致性 - 跨多场景保持人物/物体的视觉特征一致
  • 局部编辑 - 精准修改图像特定区域，不影响其他部分
  • 快速迭代 - 3-5 秒生成 1MP 图像，比 GPT-Image 快 8 倍

授权

​
Authorization
string
header
必填

请使用您的 API Token 进行认证

请求体

application/json

任务参数

​
prompt
string
必填

提示词（必填，支持英文）

Minimum string length: 1
示例:

"a beautiful landscape with mountains"

​
aspect_ratio
enum<string>
默认值:auto

宽高比（可选，默认 16:9）

可用选项:
auto,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
示例:

"16:9"

​
enable_translation
boolean
默认值:true

启用自动翻译（可选，默认 true）

示例:

true

​
input_image
string

输入图片 URL（可选，编辑模式使用）

示例:

"https://example.com/input.jpg"

​
model
enum<string>
默认值:flux-kontext-pro

模型版本（可选，默认 flux-kontext-pro）

可用选项:
flux-kontext-pro,
flux-kontext-max
示例:

"flux-kontext-pro"

​
output_format
enum<string>
默认值:jpeg

输出格式（可选，默认 jpeg）

可用选项:
jpeg,
png
示例:

"jpeg"

​
prompt_upsampling
boolean
默认值:false

启用提示词增强（可选，默认 false）

示例:

false

​
safety_tolerance
integer
默认值:2

安全容忍等级（可选，0-6，默认2）

必填范围: 0 <= x <= 6
示例:

2

​
upload_cn
boolean

使用中国大陆服务器上传（可选）

示例:

false

​
watermark
string

水印标识（可选）

示例:

""

响应

OK

​
task_id
string
必填

Task ID

示例:

"01234567-89ab-cdef-0123-456789abcdef"