Ideogram 4.5 API

Ideogram 4.5: best-in-class typography for posters, logos and graphic design.

Ideogram·图片可用

低至$0.027/ 张~~$0.03~~省 10%

模型 IDideogram-4.5

在 Playground 试用查看 API

text-to-imageimage-edittypography

输入

文本 · 图片

输出

图片

供应商

1 家供应商

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3

Quality

low · medium · high

Images

1 – 4

近 7 天表现 · 近期请求较少，暂无统计数据。

Ideogram 4.5 价格

价格按单位计费；未指定供应商时，会路由到支持该参数组合且价格最低的供应商。

规格	价格（美元）
quality: low	$0.027 / 张 3 积分~~$0.03~~省 10%
quality: medium	$0.054 / 张 6 积分~~$0.06~~省 10%
quality: high	$0.198 / 张 20 积分~~$0.22~~省 10%

接入前先试用 Ideogram 4.5

写代码之前，先测试生成效果、对比各供应商价格并预估费用。

供应商

图片

预计费用

输入

Prompt*prompt

Reference imagesimage_urls

Aspect ratioaspect_ratio

Qualityquality

Imagesnum_images

Seedseed

结果

空闲

生成结果会显示在这里。

本次请求的各供应商报价

输入提示词即可对比各供应商价格。

Ideogram 4.5 提示词示例

可直接使用的提示词，一键载入 Playground 再调整。

来源

场景分类

共 5 条提示词

A hyper-detailed miniature diorama of a cozy bookshop built inside a vintage porcelain

A hyper-detailed miniature diorama of a cozy bookshop built inside a vintage porcelain teacup: tiny bookshelves, a spiral staircase, warm lamplight in the windows, a hanging sign reading "LOST & FOUND BOOKS" and a chalkboard "OPEN · EST. 1921", steam curling like clouds above the roof. Macro photography, tilt-shift, soft morning light.

Teacup bookshop

Typography

A tiny bookshop built inside a porcelain teacup, hand-painted signs reading "LOST & FOUND BOOKS" and "OPEN · EST. 1921", steam drifting like clouds, macro tilt-shift, soft morning light.

Coffee brand logo

Logo

Minimal logo for a coffee roastery called "North Ember": a stylised flame forming a mountain peak, warm orange and charcoal, clean vector look on white.

Jazz night poster

Poster

Bold concert poster for "Blue Hour Jazz Night", Friday 9 PM, a silhouetted saxophonist, deep blue and gold palette, Art Deco typography.

Sticker sheet

Design

A sheet of six cute die-cut stickers of houseplants with smiling faces, each with a short label such as "Monstera" and "Snake Plant", white borders.

Ideogram 4.5 API 文档

该模型的接口、请求字段与可直接运行的调用示例。

Base URL

https://01router.com/api/v1

llms.txt

快速开始

将 API_KEY 设为项目密钥，在服务端运行示例。示例中的媒体地址需替换为您自己的公开地址。

自动路由会选择支持当前请求的供应商。选择指定供应商，可查看它的参数约束和调用示例。

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "ideogram-4.5",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

接口列表

这里只列出当前模型相关的接口，路径已包含 /api/v1。点击接口可跳转到使用说明。

POST

/api/v1/generations

创建生成任务（扣积分） · 需要 API 密钥

GET

/api/v1/generations/{id}

查询任务；运行中会向上游拉取状态 · 需要 API 密钥

POST

/api/v1/generations/{id}/cancel

取消进行中的生成任务（退还积分） · 需要 API 密钥

POST

/api/v1/quote

对所有供应商报价（不扣费，无需 Key） · 公开 · 无需密钥

POST

/api/v1/images/generations

兼容 OpenAI 的图片生成接口（同步等待结果） · 需要 API 密钥

GET

/api/v1/models/ideogram-4.5

查询单个模型 · 公开 · 无需密钥

鉴权

以 Bearer Token 方式发送 API Key，费用从 Key 所属账户的积分中扣除。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

获取 API Key

输入参数

使用 Content-Type: application/json 发送请求。模型参数放在 input 中，model、provider、callback_url 放在最外层。

请求体

参数名	类型	必填	说明
model	string	是	"ideogram-4.5"
provider	string	否	指定供应商；不传则自动路由到最便宜的。可选： fal
input	object	是	模型参数，字段见下方 input 字段表。
callback_url	string	否	可选的公开 HTTPS 回调地址，接收带签名的任务最终结果；仍可通过查询接口获取状态。

input · input 字段

必填字段已明确标记，其他字段省略时使用所列默认值。

参数名	类型	必填	可选值	默认值
prompt*	string	是	—	—
image_urls Optional — switches to image editing	string[]	否	maxItems: 1	—
aspect_ratio	string	否	1:1 \| 16:9 \| 9:16 \| 4:3 \| 3:4 \| 3:2 \| 2:3	1:1
quality	string	否	low \| medium \| high	medium
num_images	integer	否	min: 1 · max: 4	1
seed	integer	否	min: 0 · max: 2147483647	—

任务回调 →

输出结果

创建任务成功不代表生成完成。保存 id，查询到 succeeded 或 failed 后，读取 outputs 或 error。示例金额仅作说明，实际费用由请求决定。

queued→processing→succeeded / failed

提交后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "ideogram-4.5",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

完成后的响应

{
  "id": "gen_example",
  "object": "generation",
  "model": "ideogram-4.5",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

响应字段

参数名	类型	必填	说明
id	string	是	任务 ID，用于查询或取消任务。
object	string	是	generation
model	string	是	ideogram-4.5
type	string	是	image
provider	string	是	供应商
status	string	是	queued → processing → succeeded / failed。进入任一终态后停止轮询。
input	object	是	模型参数，字段见下方 input 字段表。
outputs	string[]	是	结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。
error	string \| null	是	失败原因；无错误时为 null。
credits	number	是	本次请求扣除的积分。
price_usd	number	是	本次请求的美元价格。
created_at	string	是	ISO 8601 格式的任务创建时间。
completed_at	string \| null	是	ISO 8601 格式的完成时间；未完成时为 null。

获取结果

每隔几秒轮询，直到 status 为 succeeded 或 failed。输出链接由供应商托管，可能过期，请及时下载保存；也可以传 callback_url 接收推送。

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed。进入任一终态后停止轮询。结果文件 URL 数组。处理中为空；成功后读取并及时下载保存。

取消任务

取消取决于供应商支持情况和任务状态。确认取消后返回 status: failed、error: Canceled by user；不支持取消或已完成的任务返回 409 not_cancelable。

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

报价

请求体与创建任务相同。返回按价格排序的可用供应商，以及无法处理该请求的供应商及原因。

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "ideogram-4.5",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "quality": "medium",
    "num_images": 1
  }
}
JSON

OpenAI 兼容图片接口

使用 OpenAI SDK 时，可调用此接口并在最外层传入 prompt。它会等待结果并返回 data[].url。异步任务和完整模型参数请使用 /generations。

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "ideogram-4.5",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON

{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

模型信息与参数

此公开接口返回模型参数，以及各供应商支持的参数约束和价格。

curl "https://01router.com/api/v1/models/ideogram-4.5"

错误码

结合 HTTP 状态码和 error.message 排查。参数或认证错误需修正后再重试；生成任务失败则通过任务本身的 status 和 error 返回。

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400请求体或参数取值不合法

401缺少或无效的 API Key

402积分不足

404模型或任务不存在

409任务无法取消（已结束，或该供应商不支持取消）

429请求过于频繁，请稍后重试

502所有供应商都拒绝了任务（积分已退回）

鉴权、路由、计费与错误码详见 →

交给 AI 使用

将本模型文档交给编程助手：纯文本包含接口、输入约束、输出字段和请求示例。

打开 llms.txt

Ideogram 4.5 与同类模型对比

并排对比规格与起步价，选择前建议用同一提示词实测。

	Ideogram 4.5	GPT Image 2.5 Flare	GPT Image 2.5 Sunburst	Nano Banana 2.1
厂商	Ideogram	OpenAI	OpenAI	Google
起步价	$0.027 / 张	$0.0053 / 张	$0.0053 / 张	$0.018 / 张
输入	文本 · 图片	文本 · 图片	文本 · 图片	文本 · 图片
供应商	1 家供应商	6 家供应商	6 家供应商	8 家供应商
Aspect ratio	1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9
Quality	low · medium · high	low · medium · high · xhigh · max	low · medium · high · xhigh · max	—
Images	1 – 4	1 – 4	1 – 4	1 – 4

Ideogram 4.5 API 常见问题

Ideogram 4.5 最适合做什么？

对文字准确性要求高的设计：海报、Logo、包装、社交媒体图和贴纸，也能生成写实或风格化图片。

质量档位有什么区别？

low 最快最便宜，medium 是默认的平衡档，high 细节最精致。图片尺寸不影响价格。

一次能出几张图？

num_images 可设 1 到 4，一次得到多个变体，很适合做 Logo 方案探索。

Ideogram 会扩写我的提示词吗？

部分供应商会自动扩写较短的提示词。把需要原样出现的文字放在引号里即可保留。

在 01router 上怎么计费？

按生成的图片张数计费，价格取决于质量档位，详见价格表。生成失败会退还积分。

Ideogram 4.5 API

Ideogram 4.5 价格

接入前先试用 Ideogram 4.5

输入

结果

本次请求的各供应商报价

Ideogram 4.5 提示词示例

A hyper-detailed miniature diorama of a cozy bookshop built inside a vintage porcelain

Teacup bookshop

Coffee brand logo

Jazz night poster

Sticker sheet

Ideogram 4.5 API 文档

快速开始

接口列表

鉴权

输入参数

请求体

input · input 字段

输出结果

提交后的响应

完成后的响应

响应字段

获取结果

取消任务

报价

OpenAI 兼容图片接口

模型信息与参数

错误码

交给 AI 使用

Ideogram 4.5 与同类模型对比

Ideogram 4.5 API 常见问题

相关模型

GPT Image 2.5 Flare

GPT Image 2.5 Sunburst

Nano Banana 2.1

Seedream 5.0 Pro

Nano Banana 2

Seedream 5.0 Flash