跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Imagen 4 API

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

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 Google-Imagen4
类型 图像生成（文生图）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Imagen 4 文生图 API：从详细文字提示词生成高质量图片。

生产建议

生产环境建议
  • 生产环境可在请求体顶层传 callback.url，减少轮询。
  • 本地调试可轮询 GET /v1/tasks/:id。

适用场景

生成日常产品与内容画面

产品主图、生活方式配图和活动草案，支持 6 种画幅，默认 16:9。

promptaspect_ratio
固定 seed 对比提示词改动

seed 是最长 500 字符的字符串，固定后只看提示词改动的效果。

seednegative_prompt

请求参数

model string 必填

固定填 Google-Imagen4。

示例 Google-Imagen4
input object 必填

模型参数放在 input 对象中。

prompt string 必填

必填的图像描述，最长 5,000 个字符。

aspect_ratio enum 必填

输出画幅比例。

默认 16:9 可选值: 1:116:99:163:44:3auto
negative_prompt string 可选

可选的反向提示词，最长 5,000 个字符。

seed string 可选

可选字符串，最长 500 个字符。

callback object 可选

可选的任务终态回调。

url string 必填

接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调时机，当前固定为 final。

默认 final 可选值: final

用例示例

生成留出标题位的产品主图

提示词分四段：任务、要画什么、保留什么、质感和限制。

请求体
{
  "model": "Google-Imagen4",
  "input": {
    "prompt": "Create a premium skincare product photo for a landing-page hero. Show one frosted glass bottle on natural stone beside still water and green botanicals. Keep the bottle centered with empty space on the left for a headline. Warm daylight and soft shadows; the result should look like calm studio photography. Do not add logos or text.",
    "aspect_ratio": "16:9"
  }
}
生成 3:4 纪实人像

详情页案例提交时的原始提示词。

请求体
{
  "model": "Google-Imagen4",
  "input": {
    "prompt": "Elderly fisherman mending nets on a harbor pier; golden hour; documentary portrait",
    "aspect_ratio": "3:4"
  }
}

获取结果

  1. 提交后立即返回 taskId。
  2. 等待 callback.url 或轮询 GET /v1/tasks/:id。
  3. status=success 后下载 output[].url。

常见问题

是否支持参考图片？

不支持。Imagen 4 只根据文字生成图片。

seed 是什么类型？

可选字符串，最长 500 个字符。

和 Fast、Ultra 怎么选？

日常生产用 Imagen 4，大量试稿用 imagen4-fast，成品需要更多细节用 imagen4-ultra。

如何获取生成结果？

凭 taskId 取。提交后立即返回 taskId，任务成功后从 output[].url 下载图片。

如何确认费用？

以任务记录为准。提交前可以看价格页和 Playground 预估。 查看价格

下一步