主题切换
图像
给一段提示词,直接拿回图片地址;也可以再带一张或多张参考图做改图(Gemini 两条支持)。接口沿用 OpenAI 的图像接口风格,已有的 SDK 或客户端只要改 Base URL 就能调用。
接口一览
| 接口 | 方法与路径 | 说明 |
|---|---|---|
| 文生图 | POST /v1/images/generations | 提交后网关同步等待出图,成功后直接返回图片地址 |
基地址 https://api.jcaigc.cn/v1,请求头带 Authorization: Bearer <密钥>(也接受 x-api-key),密钥是控制台里的 apiKey。
支持的模型
| 模型 | 说明 |
|---|---|
qwen-image-3.0-pro | 千问生图旗舰,出图质量最高的一档 |
qwen-image-3.0 | 千问生图标准版,批量出图成本最低 |
wan2.7-image | 万相文生图 |
wan2.7-image-pro | 万相文生图 Pro 档,支持调色盘与多张参考图 |
doubao-seedream-5-0-pro | 豆包生图旗舰,文生图、多参考图生图与交互编辑合一,支持图层拆分 |
doubao-seedream-5-0-flash | 与 5.0 Pro 能力一致,出图更快、单价最低,适合批量生成 |
gemini-3.1-flash-image | Gemini 3.1 文生图(Nano Banana 2),1K / 2K / 4K 三档 |
gemini-3.1-flash-lite-image | Gemini 3.1 轻量文生图(Nano Banana 2 Lite),1K / 2K / 4K 三档 |
阿里百炼的生图分两代上游协议,网关按模型名自动选择,并在请求周期内替你等完; Gemini 两条走异步协议,网关提交任务后 轮询到成图再返回。调用方不用关心上游差异。
以实际开通的模型为准
上表是网关收录的模型,真正能用哪些取决于你的账号开通了哪些通道。 调用 GET /v1/models 可以拿到当前可用的准确清单。
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
model | 是 | 模型名,取值见上表 |
prompt | 是 | 提示词,缺省会直接返回 400 缺少 prompt;Gemini 两条带参考图时可省略 |
size | 否 | 图片尺寸,写成 1024x1024 即可,网关会自动转成上游格式 |
n | 否 | 生成张数,按张数计费;Gemini 两条单次只生成 1 张,请填 1 或拆成多次请求 |
negative_prompt | 否 | 反向提示词 |
image / image_url / image_urls / images | 否 | 参考图,仅 Gemini 两条:用于在原图基础上改图,可传公网地址、data:image/...;base64,...,或 {"url": ...} / {"base64": ...} 对象;单张或数组,最多 14 张,Base64 合计不超过 10MB |
aspect_ratio / ratio | 否 | 宽高比,仅 Gemini 两条:支持 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9;不传时按 size 推导,认不出时按 1:1 |
output_format | 否 | 输出格式,仅 Gemini 两条:png / jpeg,不传由上游决定 |
seed | 否 | 随机种子,仅 Gemini 两条 |
enhance_prompt | 否 | 是否让上游扩写提示词,布尔值,仅 Gemini 两条 |
请求示例
bash
curl -X POST https://api.jcaigc.cn/v1/images/generations \
-H "Authorization: Bearer 123e4567-e89b-12d3-a456-426614174000" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.7-image",
"prompt": "一只在窗台上打盹的橘猫,晨光,浅景深",
"size": "1024x1024",
"n": 1
}'响应
出图是同步返回的,响应里直接带图片地址,不需要轮询:
json
{
"created": 1699999999,
"data": [{ "url": "https://..." }]
}同步等待有上限
异步协议的模型由网关替你等待出图:阿里系生图总预算 240 秒,Gemini 两条 总预算 600 秒。超过上限返回 504,错误码 image_timeout; 任务会由后台继续收口,不会因为客户端没等到就免费。 批量出图时建议拆成多次小请求,不要一次提交过多张。
Gemini 生图的图片地址是临时的
Gemini 两条返回的是临时访问地址,有效期 7 天。 需要长期保存的图片请及时转存到自己的存储。
计费说明
按张计费。多数模型一款一个单价,出图尺寸不参与计价;Gemini 两条按输出档位(1K / 2K / 4K)分档计价:
| 模型 | 1K | 2K | 4K |
|---|---|---|---|
gemini-3.1-flash-lite-image | 0.252 元/张 | 0.302 元/张 | 0.363 元/张 |
gemini-3.1-flash-image | 0.5 元/张 | 0.75 元/张 | 1.12 元/张 |
统一价模型:
| 模型 | 单价 |
|---|---|
qwen-image-3.0-pro | 0.5 元/张 |
qwen-image-3.0 | 0.2 元/张 |
wan2.7-image | 0.5 元/张 |
wan2.7-image-pro | 0.2 元/张 |
doubao-seedream-5-0-pro | 0.3 元/张 |
doubao-seedream-5-0-flash | 0.12 元/张 |
万相那一组是 Pro 比标准版便宜,与千问那组相反,以本表为准。 上表是网关的出厂价目表,线上实际生效的单价以控制台「模型与定价」展示的为准; 价目表里没有条目的模型一律拒绝调用(HTTP 503,error.type = model_not_priced),不会回落到任何默认价。
通用规则
| 项目 | 说明 |
|---|---|
| 张数 | 按 n 计费,一次生成 3 张就是 3 倍 |
| 输出档位 | Gemini 两条按 size 折算:1024×1024 为 1K、2048×2048 为 2K、4096×4096 为 4K;不传按 1K。宽高比会映射到上游支持的最接近比例 |
| 张数 | Gemini 两条每次只生成 1 张;其它模型按 n 计费 |
| 参考图 | 不计费;仍按输出张数与档位计价(仅 Gemini 两条) |
| 失败请求 | 上游返回错误不计费 |
计费示例:qwen-image-3.0 一次请求 n = 3,费用为 0.2 × 3 = 0.6 元; gemini-3.1-flash-image 一次请求 size = 2048x2048(按 2K 档),费用为 0.75 元。
