跳转到主要内容
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": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-3.1-flash-lite-image",
    "prompt": "赛博朋克风格的城市夜景，霓虹灯闪烁",
    "size": "16:9",
    "resolution": "1K",
    "n": 1
  }'

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

​
Authorizations

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

​
Body

​
model
string
默认值:"gemini-3.1-flash-lite-image"
必填
图像生成模型名称固定填此模型名：gemini-3.1-flash-lite-image（Nano Banana Lite）
该模型直连官方 Gemini 渠道，无 -official 变体，也不支持 official_fallback 兜底参数。
​
prompt
string
必填
图像生成的文本描述
​
size
string
图像生成的宽高比支持的比例：
  • auto - 自动选择宽高比
  • 1:1 - 方形图、头像、社交媒体
  • 3:2 / 2:3 - 标准照片
  • 4:3 / 3:4 - 传统显示器比例
  • 16:9 / 9:16 - 宽屏/竖屏视频封面
  • 5:4 / 4:5 - Instagram 图片
  • 21:9 - 超宽屏 Banner
文生图 size 为 auto 时默认 1:1 或 16:9；图生图按上游返回比例为准。（建议指定比例）
​
resolution
string
默认值:"1K"
输出图像分辨率支持的值：
  • 1K - 约 1024px，标准分辨率（Lite 仅支持此档）
Lite 只支持 1K。传 2K / 4K / 0.5K 会被静默降级为 1K，不会报错，也不会真正输出高分辨率。前端 UI 无需暴露分辨率选项。
​
n
integer
默认值:"1"
生成图像的数量取值范围：1 ~ 4，默认 1n>1 时后端会并发多次请求上游，按实际成功张数计费。建议前端固定传 1（逐张展示进度、计费更直观）。⚠️ 注意： 必须输入纯数字（如 1），不要加引号，否则会报错
​
image_urls
array
参考图像的 URL 列表，用于图生图支持两种格式：1. 完整的图像URL地址
  • 公开可访问的图像URL（http:// 或 https://）
  • 示例：https://example.com/image.jpg
2. Base64 编码格式
  • 必须使用完整的 Data URI 格式
  • 格式：data:image/{格式};base64,{base64数据}
  • 支持的图片格式：jpeg、png、webp
  • 示例：data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
  • ⚠️ 注意：必须包含 data:image/jpeg;base64, 前缀部分
限制：
  • 最多 14 张参考图（建议：最多 10 张物体参考 + 4 张角色参考）
  • 单张图片不超过 10MB
  • 支持格式：jpeg、png、webp
​
webhook
string
任务回调地址（base）任务成功 / 失败时，本平台会回调 webhook + /callback（不转发上游）。传此参数可显著减少轮询；仍建议保留轮询作兜底。
Lite 使用要点
  • 不支持 google_search / google_image_search：Lite 走 Developer API 的 interactions 端点，上游未开放 Search 工具（会返回 “Search as tool is not enabled for this model”），平台适配器也不下发该参数。传了不会报错、照常出图，但无任何搜索增强效果。需要搜索增强请改用 gemini-3.1-flash-image-preview。
  • 不支持 mask_url 局部重绘（Gemini 系列走 aspect ratio + 参考图，不走蒙版）。
  • 按 token 计费（区别于 flash/pro 的按张固定价）：输入约 0.25/百万token、图片输出约0.25/百万 token、图片输出约 30/百万 token，1K 单张 ≈ 1120 output token ≈ $0.0336/张。实际价格以后台倍率配置为准。
  • 所有生成图片含 Google SynthID 隐形水印（上游行为，无法关闭）。

​
Response

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