POST
/
api
/
v1
/
flux
/
kontext
/
generate
生成或编辑图像
curl --request POST \
  --url https://api.kie.ai/api/v1/flux/kontext/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A serene mountain landscape at sunset with a lake reflecting the orange sky",
  "enableTranslation": true,
  "aspectRatio": "16:9",
  "outputFormat": "jpeg",
  "promptUpsampling": false,
  "model": "flux-kontext-pro"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task12345"
  }
}

​
使用模式

  1. 文本到图像生成
    • 提供 prompt 和 aspectRatio
    • 模型将根据文本描述生成新图像
  2. 图像编辑
    • 提供 prompt 和 inputImage
    • 您可以选择性地提供 aspectRatio。
      • 如果提供，输出将被裁剪或填充以匹配此比例。
      • 如果省略，将保持原始图像的比例。
    • 模型将根据提示编辑输入图像

​
重要说明

  • 生成的图像将在14天后过期
  • 提示仅支持英文
  • 根据您的需求选择合适的模型：
    • flux-kontext-pro：适用于大多数用例的标准模型
    • flux-kontext-max：适用于复杂场景的增强模型

Authorizations

​
Authorization
string
header
required

所有 API 都需要通过 Bearer Token 进行认证。

获取 API Key：

  1. 访问 API Key 管理页面 获取您的 API Key

使用方法： 添加到请求头： Authorization: Bearer YOUR_API_KEY

注意：

  • 请妥善保管您的 API Key，不要与他人分享
  • 如果您怀疑 API Key 已泄露，请立即在管理页面重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.