跳转到主要内容
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-2-flex",
    "prompt": "一只蓝色的猫在草地上",
    "resolution": "1K",
    "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-2-flex",
    "prompt": "一只蓝色的猫在草地上",
    "resolution": "1K",
    "size": "16:9"
  }'

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

​
支持的模型

模型名说明计费方式
flux-2-flexFlux 2.0 Flex 图片生成模型（速度较快，适合快速迭代）按分辨率计费 (1K/2K)
flux-2-proFlux 2.0 Pro 图片生成模型（质量更高，细节更好）按分辨率计费 (1K/2K)

​
Authorizations

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

​
Body

​
model
string
必填
模型名称
  • flux-2-flex - Flux 2.0 Flex 模型（速度较快，适合快速迭代）
  • flux-2-pro - Flux 2.0 Pro 模型（质量更高，细节更好）
​
prompt
string
必填
图像生成的文本描述
​
resolution
string
默认值:"1K"
图像分辨率支持的分辨率：
  • 1K - 默认，1080p 级别
  • 2K - 高清，最大 2048 像素
支持大小写：1k、1K、2k、2K 均可
​
size
string
默认值:"1:1"
图像宽高比支持的宽高比：
  • 1:1 - 方形（默认）
  • 4:3 - 横向
  • 3:4 - 纵向
  • 16:9 - 宽屏
  • 9:16 - 竖屏
  • 3:2 - 经典横向
  • 2:3 - 经典纵向
仅支持以上 7 种比例，传入不支持的比例会返回错误
​
image_urls
array
参考图像的 URL 列表限制：
  • 最多 8 张图片
  • 必须是公网可访问的 URL
  • 不支持 base64 格式

​
分辨率对照表

比例名称1K 尺寸2K 尺寸
1:1方形1440×14401536×1536
4:3横向1664×12481824×1368
3:4纵向1248×16641368×1824
16:9宽屏1920×10802048×1152
9:16竖屏1080×19201152×2048
3:2经典横向1728×11521872×1248
2:3经典纵向1152×17281248×1872

​
使用场景示例

基础文生图 
{
    "model": "flux-2-flex",
    "prompt": "一只蓝色的猫",
    "resolution": "1K",
    "size": "16:9"
}
高分辨率生成 
{
    "model": "flux-2-pro",
    "prompt": "精细的风景画，山川河流",
    "resolution": "2K",
    "size": "16:9"
}
图生图（最多 8 张参考图） 
{
    "model": "flux-2-flex",
    "prompt": "将图片转换为水彩画风格",
    "image_urls": [
        "https://example.com/input1.jpg",
        "https://example.com/input2.jpg"
    ],
    "resolution": "1K"
}

​
Response

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

​
注意事项

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