Google

Imagen 4

imagen-4.0-ultra

Google 文生图系列，主打图像内文本渲染与复杂光照，提供 Fast、标准、Ultra 三档按质量与成本取舍

imagen-4.0 imagen-4.0-fast imagen-4.0-ultra

试用 imagen-4.0-ultra

输入

作品灵感

查看全部作品

输出

image

填写参数并生成，结果会显示在这里。

价格

imagen-4.0-ultra 每张

单价	$0.090

定位简介

imagen-4.0-ultra 是 Imagen 4 家族中面向高保真输出的文生图型号，适合需要精确提示词遵循、复杂场景构图与清晰图像内文字的生成任务。开发者通过 HiAPI.ai 统一接口以文本提示生成图像，可选 1:1、16:9、9:16、3:4、4:3 或 auto 画面比例，是品牌视觉、设计稿与概念图成品输出环节的选型。

核心亮点

提示词遵循与细节更锐利——作为 Ultra 版本，对文本提示的对齐度更强，输出更贴近指令描述，适合成品级画面生成。
图像内文本渲染改进——相较前代在图像内文字生成上有明显提升，海报、标识类内容更可用。
按画面比例直接出图——必填 aspect_ratio 支持 1:1、16:9、9:16、3:4、4:3 与 auto，无需二次裁剪即可适配投放版位。

能力说明

高保真文生图：根据文本提示生成写实风格图像，适合专业品牌与设计级输出；提示词有长度上限，需在有限字数内表达完整意图。

复杂构图与光照表现：支持复杂场景构图与复杂光照的生成需求，减少多轮重试，把一次调用用于产出可用画面。

画面比例控制：通过必填的 aspect_ratio 指定输出比例，覆盖方形、横版、竖版与 3:4、4:3 版位，适配不同渠道素材规格。

负面提示词约束：可选 negative_prompt 描述希望规避的元素，用于收敛画面内容，降低不需要元素出现的概率。

可复现生成：可选 seed 参数用于可复现的生成，便于在调试与批量生产中固定结果、对比不同提示词的效果。

适用场景

品牌与营销团队：产品卖点文案——输入品牌调性与卖点描述，生成可直接用于广告投放与社媒渠道的高保真视觉素材。
设计团队：海报与演示文稿文字需求——输入含标题文字的版式描述，产出图像内文字较清晰的初稿，用于海报、演示物料的设计参考与迭代。
概念设计：复杂构图与光照描述——输入场景、镜头与光照要求，生成高保真概念图，用于前期视觉定调与方案汇报。
开发团队：批量出图管线——通过固定 seed 与比例参数批量调用，产出风格统一的成品图，接入内容生产或素材管理流程。

限制与选型建议

仅接受文本输入，不支持图像输入编辑；提示词长度受 schema 上限约束，超长描述需精简。图像内文字虽有改进，仍需人工校验后再投放。Ultra 版本单张成本高于同家族其他版本，大批量初稿建议先用标准或 Fast 版本筛选，再以本型号输出成品；需要图像编辑或图生图能力时应选择其他模型。

近期更新

查看更新日志 →

功能变更 Imagen 4 模型 ID 改为 imagen-4.0… Oct 21, 2026
模型上新新增 Google Imagen 4 图像生成文档 Oct 14, 2026

常见问题

查看全部常见问题 →

Imagen 4 适合做什么？

适合日常的产品、生活方式和内容画面。写清主体、场景、材质和光线，就能得到可以拿去评审的图片，常用于商品主图、品牌活动草案和文章配图。
Imagen 4 支持哪些画幅比例？

支持 6 种：1:1、16:9、9:16、3:4、4:3 和 auto。aspect_ratio 必填，本页 Playground 默认 16:9。
提示词最长能写多少？

最长 5,000 字符。prompt 必填，建议按主体、场景、材质、光线、文字的顺序组织。
可以排除不想要的元素吗？

可以，用 negative_prompt。它是可选参数，最长 5,000 字符，适合排除多余文字、水印或杂乱背景。

提交生成任务

POST https://api.hiapi.ai/v1/tasks

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：imagen-4.0-ultra

routestring可选

当前固定值：default

inputobject必填

imagen-4.0-ultra 和线路 default 的业务参数对象，见下方参数表。

seedstring可选maxLength 500

可选随机种子，字符串形式；传入同一 seed 可在相同输入下复现生成结果。

promptstring必填minLength 1maxLength 5000

待生成图像的文字描述，字符串，用于指定画面内容。

aspect_ratiostring必填

输出图像的宽高比，字符串，必填。

可选项：1:116:99:163:44:3auto

negative_promptstring可选maxLength 5000

可选的反向提示词，字符串，用于描述希望在生成图像中避免出现的元素。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imagen-4.0-ultra",
  "input": {
    "prompt": "…",
    "aspect_ratio": "…"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "imagen-4.0-ultra",
    input: {
      "prompt": "…",
      "aspect_ratio": "…"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "imagen-4.0-ultra",
        "input": {
          "prompt": "…",
          "aspect_ratio": "…"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}