> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qingbo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Imagen 4.0

> Google DeepMind 旗舰文生图 — 原生 2K 输出,写实质感,中英文字渲染准确

<Warning>
  **该模型暂未开放(维护中)** — 因模型服务不稳定,`imagen-4.0` 当前未对外提供,提交请求会被拒绝。以下文档保留作能力参考,恢复开放时间另行通知。
</Warning>

Google DeepMind 出品的 **Imagen 4.0** 文生图模型 — 原生 2K 输出,写实级光影与材质,中英文字渲染准确率高。适合海报主视觉、营销主图、艺术插画等对画面质感与文字渲染要求高的场景。

按张计费,统一 2K 输出。

## 定价

| 模型           | 单价(每张)    |
| ------------ | --------- |
| `imagen-4.0` | `$0.0425` |

## 调用示例

<CodeGroup>
  ```bash 文生图(最简) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "imagen-4.0",
      "prompt": "山顶日出,云海翻涌,远处雪峰泛起金光,写实摄影风格"
    }'
  ```

  ```bash 海报场景(强文字渲染) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "imagen-4.0",
      "prompt": "电影海报,主标题大字 \"STARFALL\",副标题 \"Coming 2026\",星空背景,极简留白",
      "aspect_ratio": "9:16",
      "n": 2
    }'
  ```

  ```bash 多比例对照(横竖双版本) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "imagen-4.0",
      "prompt": "现代极简办公空间,落地窗洒入晨光,绿植点缀,杂志摄影风格",
      "aspect_ratio": "16:9",
      "seed": 42
    }'
  ```
</CodeGroup>

<ResponseExample>
  ```json 提交成功 theme={"system"}
  {
    "task_id": "task-wave1775285160b950328499",
    "model": "imagen-4.0",
    "action": "generate",
    "status": "queued",
    "created_at": 1775285160040,
    "progress": 0
  }
  ```
</ResponseExample>

提交后用 [`GET /v1/tasks/{task_id}`](/cn/api-reference/task/status) 轮询状态,详见 [任务系统](/cn/docs/task-system)。

## 可用模型

| 模型 ID        | 说明                                      |
| ------------ | --------------------------------------- |
| `imagen-4.0` | Google DeepMind 旗舰文生图,原生 2K,写实质感,中英文字准确 |

## 通用参数

<ParamField body="model" type="string" required>
  从 [可用模型](#可用模型) 列表中选一个
</ParamField>

<ParamField body="action" type="string" default="generate">
  操作类型,Imagen 4.0 仅支持:

  * `generate` — 文生图(默认)
</ParamField>

<ParamField body="prompt" type="string" required>
  图像描述文本,支持中英文。Imagen 4.0 对场景细节、光影与文字渲染表现尤佳
</ParamField>

<ParamField body="n" type="integer" default="1">
  生成数量(单次返回多张)
</ParamField>

<ParamField body="seed" type="integer" default="-1">
  随机种子,`-1` 为随机;固定值可复现相似结果
</ParamField>

<ParamField body="aspect_ratio" type="string" default="1:1">
  画面宽高比,可选值:

  * `1:1` — 正方形
  * `4:3` / `3:4` — 横/竖版标准
  * `16:9` / `9:16` — 横/竖版宽屏
</ParamField>

<ParamField body="resolution" type="string">
  输出分辨率,Imagen 4.0 默认原生 2K,**无独立分辨率档位**,留空即可
</ParamField>

<ParamField body="callback_url" type="string">
  Webhook 回调地址,任务终态时调用。详见 [回调机制](/cn/docs/sync-async#异步任务-webhook)
</ParamField>

<ParamField body="callback_events" type="string[]">
  需要回调的事件类型,默认全部终态事件
</ParamField>

## 资源限制

| 项目        | 限制                                            |
| --------- | --------------------------------------------- |
| 支持 action | 仅 `generate`(纯文生图)                            |
| 输出分辨率     | 原生 2K(固定,无档位选择)                               |
| 宽高比       | `1:1` / `4:3` / `3:4` / `16:9` / `9:16` 共 5 种 |
| 输出文件      | JPG,链接 24 小时有效                                |

## 相关文档

* [任务系统详解](/cn/docs/task-system) — 任务状态机 / 轮询节奏 / 异步推送
* [请求响应格式](/cn/docs/request-response) — 通用错误码 / Headers / 限流
* [认证](/cn/docs/authentication) — API Key 申请与使用