Skip to content

图像 ​

← 返回全部能力

给一段提示词,直接拿回图片地址;也可以再带一张或多张参考图做改图(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-imageGemini 3.1 文生图(Nano Banana 2),1K / 2K / 4K 三档
gemini-3.1-flash-lite-imageGemini 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)分档计价:

模型1K2K4K
gemini-3.1-flash-lite-image0.252 元/张0.302 元/张0.363 元/张
gemini-3.1-flash-image0.5 元/张0.75 元/张1.12 元/张

统一价模型:

模型单价
qwen-image-3.0-pro0.5 元/张
qwen-image-3.00.2 元/张
wan2.7-image0.5 元/张
wan2.7-image-pro0.2 元/张
doubao-seedream-5-0-pro0.3 元/张
doubao-seedream-5-0-flash0.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 元。

相关模块 ​

最后更新于: