跳转到主要内容
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 像素
支持大小写:1k1K2k2K 均可
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 张参考图片