跳转到主要内容
POST
https://api.apimart.ai
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "把头发变成蓝色",
    "image_urls": ["https://example.com/input.png"],
    "size": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "flux-kontext-pro",
    "prompt": "把头发变成蓝色",
    "image_urls": ["https://example.com/input.png"],
    "size": "16:9"
  }'

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

​
支持的模型

模型名说明计费方式
flux-kontext-proFlux Kontext Pro 图片编辑模型固定价格
flux-kontext-maxFlux Kontext Max 图片编辑模型（更高质量）固定价格

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
模型名称
  • flux-kontext-pro - Kontext Pro 模型
  • flux-kontext-max - Kontext Max 模型（更高质量）
​
prompt
string
必填
图像生成的文本描述
​
image_urls
array
输入图片 URL 列表限制：
  • 仅支持 1 张图片
  • 必须是公网可访问的 URL
  • 不支持 base64 格式
​
size
string
默认值:"有图: match_input_image，无图: 16:9"
图像宽高比支持的宽高比：
  • match_input_image - 匹配输入图片比例（有图时默认）
  • auto - 等同于 match_input_image
  • 1:1 - 正方形
  • 4:3 - 横向 4:3
  • 3:4 - 纵向 3:4
  • 16:9 - 横向宽屏（无图时默认）
  • 9:16 - 纵向竖屏
  • 3:2 - 横向 3:2
  • 2:3 - 纵向 2:3
  • 21:9 - 超宽屏
  • 9:21 - 超竖屏
​
response_format
string
默认值:"png"
输出图片格式
  • png - PNG 格式（默认）
  • jpg - JPEG 格式
​
safety_tolerance
integer
默认值:"2"
安全容忍度取值范围：0-6，数值越高越宽松
​
prompt_upsampling
boolean
默认值:"false"
是否启用提示词增强
  • true - 启用
  • false - 禁用（默认）

​
使用场景示例

图片编辑（带输入图片） 
{
    "model": "flux-kontext-pro",
    "prompt": "把背景换成海滩",
    "image_urls": ["https://example.com/photo.jpg"]
}
纯文生图（无输入图片） 
{
    "model": "flux-kontext-pro",
    "prompt": "一只蓝色的猫",
    "size": "16:9"
}

​
Response

​
code
integer
响应状态码
​
data
array
返回数据数组

​
注意事项

  1. 图片 URL 要求：输入图片必须是公网可访问的 URL，不支持 base64
  2. 结果存储：生成的图片会自动存储，返回的 URL 有效期 24 小时
  3. 任务轮询：任务为异步处理，需要轮询 /v1/tasks/{task_id} 获取结果
  4. 输入图片限制：仅支持 1 张图片