Ideogram

Ideogram V4.5

ideogram-v4.5/image-to-image

以排版文字清晰、多轮精准局部编辑见长的图像生成与编辑模型，原生 2K，适合海报、Logo 与包装设计

ideogram-v4.5/image-to-image ideogram-v4.5/text-to-image

试用 ideogram-v4.5/image-to-image

输入

作品灵感

查看全部作品

输出

image

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

价格

ideogram-v4.5/image-to-image 每张

规格	单价
very_low	$0.0115
low	$0.043
medium	$0.086
high	$0.3145

定位简介

ideogram-v4.5/image-to-image 是面向图像编辑场景的模型，接收一张主源图，可用提示词改写、替换或局部重绘。除主图外可附最多四张参考图约束风格与内容，或配遮罩精确定位改动区域；另有 regular 与 high 两档编辑精度，high 走 Precise Edit 路径。适合需要反复迭代素材的设计、电商与内容团队，在已有图上做可控修改而非从零生成。

核心亮点

高精度编辑减少多轮改动累积失真——edit_precision 设为 high 时走 Precise Edit 路径，改动集中到指令所指区域，适合一轮接一轮打磨同一张图。
参考图与遮罩组合控制编辑范围——主图之外可再传参考图，有遮罩时最多三张；遮罩与源图尺寸匹配，即可把改动限定在指定区域。
多档质量与多种画幅可选——quality 提供 very_low 到 high 四档，image_size 覆盖方形、横竖版常用比例，默认 auto 跟随构图。

能力说明

自然语言图像编辑：以 prompt 描述想要的改动，模型在源图基础上重绘。适合替换背景、调整产品细节或改变画面氛围，无需手工蒙版即可完成整图级修改。

遮罩局部重绘：同时传入 mask_url 与尺寸匹配的遮罩，只重绘遮罩覆盖区域，其余像素保持原样，用于局部替换元素、去除或补充内容。

参考图引导风格：reference_image_urls 最多可传四张，有遮罩时最多三张，用参考图约束配色、风格或主体特征，让多次编辑的输出保持统一。

编辑精度与质量分档：edit_precision 选 high 时启用精准编辑；quality 可选 very_low 至 high，预校对构图或排版时用低档快速出稿，定稿再用高档生成。

画幅与种子控制：image_size 支持方形、4:3、16:9 等常用比例或 auto 自适应；seed 固定后可复现同一图上的编辑结果，便于对照比较。每次请求输出一张图。

适用场景

电商运营对现有商品图做局部替换——用遮罩圈出背景或配件区域并附提示词重绘，产出可直接上架的商品图，省去重新拍摄。
设计团队在初稿上多轮修改海报——以已有海报为源图逐轮调整构图与文案位置，用 high 精度减少累积伪影，产出可交付的版本。
品牌方探索同风格的视觉变体——传入多张参考图统一风格，在源图基础上生成不同配色的衍生稿，用于物料延展与方案比选。
内容团队为已有素材统一色调——用提示词与参考图批量调整现有图片的季节或主题氛围，产出适配不同档期的宣传图。

限制与选型建议

单次请求固定输出一张图，不适合需要成组候选稿的批量探索；输出上限为 2K，交付大幅面印刷物料时需另行放大。遮罩需与源图尺寸匹配，复杂选区需事先准备蒙版。编辑效果依赖提示词描述精度，结构性大改（如整体换构图）更适合重新生成。多轮修改建议全程使用 high 精度档以控制质量衰减。

近期更新

查看更新日志 →

功能变更 Ideogram 4.5 文生图的模型 ID 改为 ideogram-v4.5/text-to-image。原来的 id… Oct 21, 2026
模型上新新增 ideogram-v4.5 文生图与 ideogram-v4.5/image-to-image 图片编辑文档。文生… Oct 16, 2026

常见问题

查看全部常见问题 →

Ideogram 4.5 Edit 能做哪些编辑？

能做四种编辑：提示词整体编辑、参考图改风格、蒙版局部重绘和 Precise Edit 精修。四种方式可以组合使用。
至少需要哪些字段？

prompt 和 image_url 必填。reference_image_urls、mask_url、edit_precision、quality、image_size、num_images、seed 按需添加。
regular 和 Precise Edit 有什么区别？

改字和小范围精修选 Precise Edit，换色、换风格选 regular。edit_precision=high 即 Precise Edit，会还原没有改动的像素；regular 改动更自由。
两种精度的质量档一样吗？

不一样。regular 可选 very_low、low、medium、high；Precise Edit 只有 low、medium、high。

提交生成任务

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必填

当前固定值：ideogram-v4.5/image-to-image

routestring可选

当前固定值：default

inputobject必填

ideogram-v4.5/image-to-image 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选

随机种子，用于控制生成结果的可复现性；取整数，相同种子与其余参数一致时结果趋于稳定。

promptstring必填minLength 1maxLength 10000

生成或编辑的提示词，以字符串形式描述期望的画面内容或修改意图。

qualitystring可选默认值: "medium"

编辑质量档位，取字符串，默认 medium；当 edit_precision 为 high 时仅支持 low、medium、high。

可选项：very_lowlowmediumhigh

mask_urlstring可选

蒙版图片的 URL，蒙版尺寸需与源图尺寸一致，用于限定编辑区域。

image_urlstring必填

待编辑的主源图 URL，作为图像到图像生成的输入图像。

image_sizestring可选默认值: "auto"

输出图像尺寸，取字符串，默认 auto，由服务按输入自动决定。

可选项：autosquaresquare_hdportrait_4_3landscape_4_3portrait_16_9landscape_16_9

num_imagesinteger可选默认值: 1min 1max 1

输出图像数量，取整数，默认 1；当前每请求仅生成一张，num_images 必须为 1。

edit_precisionstring可选默认值: "regular"

编辑精度模式，取字符串，默认 regular；设为 high 时启用 Precise Edit 精确编辑。

可选项：regularhigh

reference_image_urlsarray可选maxItems 4

参考图 URL 数组，最多四个参考图；当提供蒙版时最多使用三个。

Array [ string ]

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": "ideogram-v4.5/image-to-image",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "image_url": "…",
    "image_size": "auto",
    "num_images": 1,
    "edit_precision": "regular"
  }
}'

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: "ideogram-v4.5/image-to-image",
    input: {
      "prompt": "…",
      "quality": "medium",
      "image_url": "…",
      "image_size": "auto",
      "num_images": 1,
      "edit_precision": "regular"
    }
  }),
});
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": "ideogram-v4.5/image-to-image",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "image_url": "…",
          "image_size": "auto",
          "num_images": 1,
          "edit_precision": "regular"
        }
    },
)
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"
    }
  }
}