什么是 AI 图像生成 API?
ImgGen AI 图像生成 API 是一个 REST 端点,它把文本提示词变成图像。您发送一个 JSON 请求体,其中包含提示词、想要的样本数量、宽高比以及所用模型;端点会以数组形式返回 base64 编码的生成图像。它是唯一接收 JSON 而非文件的端点。
这是 ImgGen AI 图像编辑 API 七个端点之一,它们共用同一个 API 密钥、同一个基础 URL,以及相同的请求与响应格式。如果您还需要在浏览器中而非通过代码使用该功能,同一套 AI 模型也驱动着 AI Image Generator 工具。
请求参数
向 https://app.imggen.ai/v1/generate-image 发送一个 POST 请求,并在 Authorization 请求头中使用 API 密钥进行认证。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| prompt | string | 必填 | — | 对所要生成图像的文本描述。 |
| samples | number | 可选 | 1 | 生成多少张图像,取值 1 到 4。 |
| aspect_ratio | string | 可选 | square | 输出形状。接受 square、portrait 或 landscape。 |
| model | string | 可选 | imggen-base | 生成模型。接受 imggen-base、imggen-base-fast 或 imggen-xl。 |
如何集成 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"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))响应
成功的调用会返回 JSON。结果为 base64 编码——写入磁盘或对象存储前请先解码。每次成功的响应还会带上 X-Credit-Remaining 请求头,显示本次调用后的余额。
{
"success": true,
"message": "Images generated successfully",
"images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}值得了解的限制与行为
该端点接受 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 表单。
AI 图像生成 API 用在哪些场景?
各团队将此端点用于生产环境,以编程方式大规模处理图像的场景。
编辑与博客配图
根据标题为每篇文章生成一张原创头图,而不是去图库里拿一张别人也在用的图。
产品与营销概念探索
一次调用产出同一视觉想法的四个变体,让团队在委托实际制作前先定方向。
应用内创意功能
让用户在您的产品里生成图像,而您无需搭建 GPU 基础设施。
占位与演示内容
用按需生成的、看起来合情合理的图像,填充演示、原型和预置环境。
AI 图像生成 API 的费用是多少?
每次成功调用消耗 3 积分起,因此单张图片的实际成本取决于您所用的套餐。积分来自您的套餐,并在所有端点与网页编辑器之间共用,您无需为每个工具单独购买配额。调用失败会自动退还。完整细节见价格页面。
| 套餐 | 价格 | 积分 | API |
|---|---|---|---|
| Free | $0 | 50 个一次性免费积分 | 不含 API 访问 |
| Starter | $9.99 / month | 每月 400 积分 | 含 API 访问 |
| Pro | $29.99 / month | 每月 1,400 积分 | API 访问 + 优先支持 |
| Enterprise | Custom | 定制用量 | 专属基础设施 |
积分费用与限制最近核实于 2026-08-27.
相关端点与工具
使用 AI 图像生成 API 的团队,接下来通常还会用到这些。
AI 图像生成 API 常见问题
- 它是一个 HTTP 端点,把文字描述变成图像。您以 JSON 形式发送提示词,服务会在响应中返回生成的图像——这让一款产品无需自行运行任何模型基础设施,就能提供文本生成图像的能力。
- 1 到 4 张,由 samples 参数设定。所有请求的图像会在同一个响应的单个 images 数组中一并返回。
- 三种:imggen-base 是默认模型,在质量与速度之间取得平衡;imggen-base-fast 返回更快但细节更少;imggen-xl 追求最高质量。通过 model 参数按请求选择。
- square、portrait 和 landscape,由 aspect_ratio 设定。若不填写,默认为 square。
- 生成按模型计费而非统一价,因为各模型的算力开销差异很大。默认模型从每张 3 积分起,质量更高的模型费用更高。每次成功调用都会在 X-Credit-Remaining 响应头中返回您的剩余余额,各模型的实时费用可在 ImgGen 账户中查看。
- 归您所有。ImgGen 不对 API 返回的任何内容主张所有权,且每个套餐都附带完整商业使用权、不带水印。请注意,各法域对 AI 生成图像的著作权认定不尽相同,若所有权对您的用例具有法律上的关键意义,请核实当地规定。
- 可以。包括免费套餐在内的所有套餐都包含完整的商业使用权,且任何输出都不带水印。API 返回的任何内容,您都可以出售、打印或发布。
- 生成的图像在响应中返回,不会被保留。与所有 ImgGen 端点一样,唯一保存的是一条使用日志,记录发生过一次调用以及花费了多少。您的内容不会用于训练模型。