---
url: /image.md
description: >-
  简创AIGC 图像能力文档：文生图接口 POST /v1/images/generations，兼容 OpenAI 图像接口风格，基地址
  https://api.jcaigc.cn/v1，支持千问生图 qwen-image-3.0、万相 wan2.7-image、豆包
  doubao-seedream-5-0 与 Gemini gemini-3.1-flash-image 等模型，按张计费（0.12~1.12 元/张）。
---

# 图像

[← 返回全部能力](/)

给一段提示词，直接拿回图片地址；也可以再带一张或多张参考图做改图（Gemini 两条支持）。接口沿用 OpenAI 的图像接口风格，已有的 SDK 或客户端只要改 Base URL 就能调用。

## 接口一览

| 接口 | 方法与路径 | 说明 |
|------|-----------|------|
| 文生图 | `POST /v1/images/generations` | 提交后网关同步等待出图，成功后直接返回图片地址 |

基地址 `https://api.jcaigc.cn/v1`，请求头带 `Authorization: Bearer <密钥>`（也接受 `x-api-key`），密钥是[控制台](https://jcaigc.cn)里的 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 两条走异步协议，网关提交任务后
轮询到成图再返回。调用方不用关心上游差异。

::: tip 以实际开通的模型为准
上表是网关收录的模型，**真正能用哪些取决于你的账号开通了哪些通道**。
调用 `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://..." }]
}
```

::: warning 同步等待有上限
异步协议的模型由网关替你等待出图：阿里系生图总预算 **240 秒**，Gemini 两条
总预算 **600 秒**。超过上限返回 `504`，错误码 `image_timeout`；
任务会由后台继续收口，不会因为客户端没等到就免费。
批量出图时建议拆成多次小请求，不要一次提交过多张。
:::

::: tip 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` 元。

## 相关模块

* [视频](/video/) — 文生视频与图生视频
* [数字人](/avatar/) — 图片说话与视频对口型，让人物按音频开口
* [大语言模型](/llm/) — 对话补全
