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

Ideogram 4.5 文生图 API

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

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

模型概览

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

Ideogram 4.5 文生图：适合 Logo、字标、海报和招牌等文字优先的图片，支持 low、medium、high 三档质量与 1–8 张输出。

生产建议

生产环境建议
  • 生产环境可以在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时通知你的服务。
  • GET /v1/tasks/:id 适合本地调试、低频任务或回调失败后的补偿查询。
  • success 和 fail 都是终态，请按 taskId 做幂等处理。

适用场景

文字优先的品牌视觉

适合 Logo、字标、海报和招牌等需要清晰画面文字的视觉。

promptquality
三档质量选择

根据探索、日常创作或最终细节选择 low、medium 或 high。

quality
批量输出

一次任务可请求 1–8 张图片，方便比较构图方向。

num_images

请求参数

model string 必填

固定填 ideogram-v4.5。

示例 ideogram-v4.5
input object 必填

业务参数对象；Ideogram 4.5 文生图的配置放在这里。

prompt string 必填

描述要生成的画面，并把需要出现的文字逐字写出；长度为 1–10000 个字符。

quality enum 可选

输出质量档位；low 适合快速探索，high 适合更细致的最终画面。

默认 medium 可选值: lowmediumhigh
image_size enum 可选

输出尺寸预设。文生图省略时使用 square_hd。

默认 square_hd 可选值: squaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9
enable_prompt_expansion boolean 可选

是否自动扩展提示词以补充画面细节。

默认 true
num_images integer 可选

一次生成的图片数量，范围为 1–8。

默认 1
seed integer 可选

可选随机种子；使用相同输入和种子有助于复现结果。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

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

回调触发时机；当前使用 final。

默认 final 可选值: final

用例示例

设计大会海报

low 档横版 16:9，大标题与副标题层级清晰。

请求体
{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Minimal modern brand poster for a design conference. Huge bold headline text \"DESIGN FORWARD\" centered, smaller subtitle \"Typography Summit 2026\" below, clean Swiss grid layout, warm orange and deep navy palette, geometric shapes, crisp sharp lettering",
    "quality": "low",
    "image_size": "landscape_16_9",
    "num_images": 1
  }
}
咖啡店字标

low 档方图，手绘衬线字标加标语。

请求体
{
  "model": "ideogram-v4.5",
  "input": {
    "prompt": "Elegant wordmark logo for a specialty coffee shop called \"Ember & Oak\", hand-drawn serif lettering with a small coffee bean emblem, tagline \"Small Batch Roasters\" beneath, cream background, dark brown ink, centered, vector style",
    "quality": "low",
    "image_size": "square_hd",
    "num_images": 1
  }
}

获取结果

  1. 提交成功后立即返回 taskId。
  2. 生产环境优先等待 callback.url 的终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后从 output[].url 下载图片。
  4. status=fail 时根据错误信息修正请求。

常见问题

Ideogram 4.5 文生图适合什么？

适合 Logo、字标、海报、招牌和其他需要清晰画面文字的图片。

quality 怎么选？

low 适合快速探索，medium 适合日常创作，high 适合需要更多细节的最终画面。

可以一次生成多张吗？

可以，使用 num_images 指定 1–8 张输出。

如何编辑已有图片？

使用 ideogram-v4.5/image-to-image，并在 input.image_url 提供主源图片。

下一步