I

Ideogram 4.5 API

生成带文字的海报、标志和图片,支持 1K、2K 与三档画质。

价格比较

同一输出规格,比较各渠道公开价

比较其他模型
输出规格渠道渠道公开价接口耗时试用
1K
Ideogram官方
仅为参考价,不能通过 Yir 调用
FAL
接口耗时 14秒
14秒试用
2K
Ideogram官方
仅为参考价,不能通过 Yir 调用
FAL
试用
计价说明

按实际执行渠道计费;故障转移时可能切换渠道,费用和耗时随之变化。

API 接入

交给编码 Agent 写代码,在对话里用 MCP 或 Skill 直接生成,或用 SDK、OpenAI 兼容 API 自己接入。

让编码 Agent 接入

复制接入提示词,或直接在 Codex、Claude 中打开。Agent 会读取本页与模型合同,在你的项目里写好提交、等待和取结果。

添加 Yir MCP 服务器

接进 ChatGPT、Claude、Cursor 后,在对话里 @Yir 并点名 Ideogram 4.5;它会先报价,你确认后才生成。

https://gateway.yir.ai/mcp
各客户端接入步骤

Claude Code 一行命令

先在控制台创建 API Key 并设为环境变量 YIR_API_KEY,再运行:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

安装 Yir Skill

在 Agent 运行环境里设好 YIR_API_KEY,装进 Claude Code、Codex 等编码 Agent 后,直接说“用 Yir 的 Ideogram 4.5 生成……”。

npx skills add yir-ai/skills
了解 Yir Skill

通过包管理器安装官方 SDK,或直接复制下方代码进行集成

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// 默认从环境变量读取 YIR_API_KEY: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. 提交图片生成任务
const job = await client.submitImage({
model: "ideogram/ideogram-4.5",
input: {
type: "text",
prompt: "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
},
parameters: {
quality: "medium",
resolution: "1K",
aspect_ratio: "1:1",
n: 1,
},
});
 
// 2. 等待任务完成并交付结果
const result = await client.waitForJob(job.id);
console.log("交付文件:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

已按 OpenAI 协议对接的项目,或 new-api 等网关,只需更换 Base URL 和 Key。 OpenAI 兼容说明

OpenAI SDK base_url
https://gateway.yir.ai/openai/v1
new-api 渠道 Base URL
https://gateway.yir.ai/openai
密钥
Yir API Key
模型 ID
ideogram/ideogram-4.5
curl https://gateway.yir.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ideogram/ideogram-4.5",
    "prompt": "为一款柑橘气泡水设计产品海报:透明玻璃瓶与鲜橙,奶油色背景,柔和自然光,清晰的产品标签",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "quality": "medium"
  }'

参数概览

常用参数,具体限制以当前模型及所选渠道为准

API 文档
分辨率
resolution
  • 1K
  • 2K

成图或成片的分辨率档位,更高规格拥有更多像素细节,按档位计费

宽高比
aspect_ratio
  • 1:1
  • 4:3
  • 3:4
  • 16:9
  • 9:16

画面几何比例,建议依据展示媒介(手机竖屏、横屏横幅或方形)指定

输入方式
input_mode
  • 文字生成

依据自然语言提示词从零生成画面

常见问题

开始使用 Ideogram 4.5

同规格跨渠道比价,一个钱包调用多个渠道。