跳转到主要内容
POST
/
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": "gpt-image-1-official",
    "prompt": "星空下的古老城堡",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "星空下的古老城堡",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

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

​
支持的模型

模型名说明模式图生图最大张数计费方式
gpt-image-1-official稳定优先，适合通用图片生成文生图 / 图生图支持4 张尺寸×质量
gpt-image-1.5-official新版本，适合更高质量和更复杂编辑场景文生图 / 图生图支持4 张尺寸×质量

​
Authorizations

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

​
Body

​
model
string
必填
模型名称
  • gpt-image-1-official - 稳定优先，适合通用图片生成
  • gpt-image-1.5-official - 新版本，适合更高质量和更复杂编辑场景
​
prompt
string
必填
图像生成的文本描述，支持中英文
​
size
string
默认值:"1:1"
画面比例支持的比例：
  • 1:1 - 正方形构图（默认）
  • 3:2 - 横构图
  • 2:3 - 竖构图
​
n
integer
默认值:"1"
生成图片张数取值范围：1-4
  • 传入值 ≤ 0 时，系统按 1 处理
  • 传入值 > 4 时，系统按 4 处理
⚠️ 注意： 必须输入纯数字（如 1），不要加引号，否则会报错
​
quality
string
默认值:"auto"
图片质量
  • auto - 自动选择质量（默认）
  • low - 更快、更省
  • medium - 质量与消耗折中
  • high - 质量更高，消耗更高
​
background
string
默认值:"auto"
背景模式
  • auto - 自动背景（默认）
  • opaque - 不透明背景
  • transparent - 透明背景，推荐搭配 png 输出格式
background: transparent 不能和 output_format: jpeg 同时使用
​
moderation
string
默认值:"auto"
审核强度
  • auto - 默认审核强度
  • low - 更宽松的审核强度
​
output_format
string
默认值:"png"
输出格式
  • png - 默认格式，适合透明背景
  • jpeg - 文件更小，适合普通图片输出
background: transparent 不能和 output_format: jpeg 同时使用
​
output_compression
integer
输出压缩强度，范围 0-100
  • 建议仅在 jpeg 下使用
  • png 场景建议不传
​
image_urls
array
参考图像的 URL 数组，传入后自动按图生图处理限制： 最多 15 张参考图
​
mask_url
string
遮罩图 URL，用于局部重绘（inpainting）
  • 需搭配 image_urls 一起使用
  • 传入后会按官方编辑接口一并提交
1、上传遮罩图前，请先确认图片 Alpha 通道为「是」。2、遮罩图尺寸需与首张参考图一致。

​
尺寸对照表

对外统一使用比例值，系统内部自动映射到官方实际尺寸并完成计费。
比例实际尺寸说明
1:11024×1024正方形构图
2:31024×1536竖构图
3:21536×1024横构图

​
使用场景示例

文生图（最简请求） 
{
  "model": "gpt-image-1-official",
  "prompt": "星空下的古老城堡"
}
文生图（完整参数） 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
图生图（单参考图） 
{
  "model": "gpt-image-1.5-official",
  "prompt": "将参考图改成插画风格，保留主体轮廓",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
图生图（多参考图融合） 
{
  "model": "gpt-image-1.5-official",
  "prompt": "将两张参考图融合成一张插画海报，保留主体轮廓",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
多张生成（n > 1） 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

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

​
注意事项

  1. 异步处理：提交后返回 task_id，需轮询 /v1/tasks/{task_id} 获取结果
  2. 模型选择：通用图片生成优先使用 gpt-image-1-official，高质量编辑和复杂图生图建议使用 gpt-image-1.5-official
  3. 图片 URL 要求：图生图推荐使用公网可直接访问的稳定图片 URL
  4. 计费规则：按成功生成的图片张数计费，失败不扣费