3 积分起 每次调用

AI 图像生成 API

用一个 JSON 请求,根据文本提示词生成图像。每次调用最多四个样本,三种模型可在速度与质量之间取舍,输出享有完整商业权利。

  • REST · JSON
  • 无水印
  • 不存储任何内容
endpoint

POST /v1/generate-image

基础 URL
https://app.imggen.ai
认证
Authorization: Bearer sk_live_…
费用
3 积分起
输入
JPEG (JPG), PNG and WebP · max 25 MB

01 — 概览

什么是 AI 图像生成 API?

ImgGen AI 图像生成 API 是一个 REST 端点,它把文本提示词变成图像。您发送一个 JSON 请求体,其中包含提示词、想要的样本数量、宽高比以及所用模型;端点会以数组形式返回 base64 编码的生成图像。它是唯一接收 JSON 而非文件的端点。

这是 ImgGen AI 图像编辑 API 七个端点之一,它们共用同一个 API 密钥、同一个基础 URL,以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能,同一套 AI 模型也驱动着 AI Image Generator 工具。

02 — 请求

请求参数

https://app.imggen.ai/v1/generate-image 发送一个 POST 请求,并在 Authorization 请求头中使用 API 密钥进行认证。

此端点接受的参数
参数类型必填默认值说明
promptstring必填对所要生成图像的文本描述。
samplesnumber可选1生成多少张图像,取值 1 到 4。
aspect_ratiostring可选square输出形状。接受 square、portrait 或 landscape。
modelstring可选imggen-base生成模型。接受 imggen-base、imggen-base-fast 或 imggen-xl。
03 — 集成

如何集成 AI 图像生成 API?

在您的 ImgGen 账户中创建一个 API 密钥,将其设为环境变量,然后调用该端点。以下是同一个请求的 cURL、Node.js 与 Python 写法。

curl --request POST \
  --url 'https://app.imggen.ai/v1/generate-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "close up photo of a rabbit in a wildflower meadow",
    "samples": 1,
    "aspect_ratio": "square",
    "model": "imggen-base"
  }'
04 — 响应

响应

成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头,显示本次调用后的余额。

{
  "success": true,
  "message": "Images generated successfully",
  "images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}
05 — 限制

值得了解的限制与行为

该端点接受 JPEG(JPG)、PNG 和 WebP,文件最大 25 MB,并在 60 秒内同步返回结果——无需轮询任务,也无需配置 webhook。

返回 images 数组

与返回单个 image 字段的编辑类端点不同,生成端点返回的是 images——一个数组,每个请求的样本对应一项。

三种模型

imggen-base 是默认的平衡选择,imggen-base-fast 以细节换速度,imggen-xl 追求最高质量。按请求选择,而不是按账户设定。

JSON,而非 multipart

这是唯一接收 JSON 请求体的端点。请发送 Content-Type: application/json,而不是 multipart 表单。

06 — 生产实践

AI 图像生成 API 用在哪些场景?

各团队将此端点用于生产环境,以编程方式大规模处理图像的场景。

编辑与博客配图

根据标题为每篇文章生成一张原创头图,而不是去图库里拿一张别人也在用的图。

产品与营销概念探索

一次调用产出同一视觉想法的四个变体,让团队在委托实际制作前先定方向。

应用内创意功能

让用户在您的产品里生成图像,而您无需搭建 GPU 基础设施。

占位与演示内容

用按需生成的、看起来合情合理的图像,填充演示、原型和预置环境。

07 — 费用

AI 图像生成 API 的费用是多少?

每次成功调用消耗 3 积分起,因此单张图片的实际成本取决于您所用的套餐。积分来自您的套餐,并在所有端点与网页编辑器之间共用,您无需为每个工具单独购买配额。调用失败会自动退还。完整细节见价格页面

ImgGen AI 套餐与 API 访问
套餐价格积分API
Free$050 个一次性免费积分不含 API 访问
Starter$9.99 / month每月 400 积分含 API 访问
Pro$29.99 / month每月 1,400 积分API 访问 + 优先支持
EnterpriseCustom定制用量专属基础设施

积分费用与限制最近核实于 2026-08-27.

08 — 相关

使用 AI 图像生成 API 的团队,接下来通常还会用到这些。

背景移除 API图像放大 APIAI Image Generator (网页工具)全部 API 端点

另可使用: 水印移除, 文字移除, 照片修复, 照片上色.

FAQ

AI 图像生成 API 常见问题

它是一个 HTTP 端点,把文字描述变成图像。您以 JSON 形式发送提示词,服务会在响应中返回生成的图像——这让一款产品无需自行运行任何模型基础设施,就能提供文本生成图像的能力。

开始使用

开始调用 AI 图像生成 API

一个密钥即可解锁全部七个端点。无水印、完整商业权利,且您发送的任何内容在响应返回后都不会被保留。

获取 API 密钥