进阶 docs.ideogram.ai 2026-11-19 18:13:23 · 12 阅读

第50章 Ideogram API 使用指南:密钥管理、额度与用量

Ideogram API 用于创建和撤销 Ideogram API 密钥、选择消耗的额度、筛选用量报告,以及在应用中查询操作价格。以 Markdown 查看

Ideogram API 让你可以用自己的代码生成和编辑图片。本页介绍应用内的管理操作;关于端点、请求格式和示例,请参考 developer.ideogram.ai 上的 API 文档。

打开 API 页面

点击你的头像,点击 API 打开 Settings → API Overview。侧边栏的 API 按钮在集成应用中也能打开这个概览页。

工作区切换器用于选择当前操作的账户或组织,创建密钥或管理额度前请先选好工作区。

在 Ideogram Legacy 中,API 会打开一个单独的 API 页面,使用其中的 Dashboard、API Keys、Usage 和 Billing 页面,它有自己的工作区切换器。你能看到的页面和操作取决于所选工作区以及你的角色。

页面会显示:

额度余额(Credit balance):你剩余的额度。点击 Manage credits 打开 Wallet & Billing。后付费企业工作区不会在这里显示预付余额。

当前套餐(Current plan):你所在的套餐。

Create an API key 和 View our docs 入口。

Track your usage(当你的工作区支持 Usage 页面时),见 Track usage。

MCP server:把 Ideogram 连接到支持 Model Context Protocol 的 AI 工具。

API Overview 示例。额度余额和 Track your usage 卡片取决于工作区和你的权限。

Settings 中的 Usage costs 列出了支持操作的定价。它是价目表;Usage(在可用时)显示实际记录的消费。

创建 API 密钥

选择密钥要使用的工作区额度。

打开 API Keys,或在概览页选择 Create an API key。

点击 Create key。

输入可选的名称(最长 64 个字符),然后点击 Create。

在确认对话框中复制完整密钥并妥善保存,然后关闭对话框。

警告:完整密钥只显示一次,之后无法从密钥列表中再次查看。如果丢失,需要创建新密钥、更新使用它的应用,再撤销旧密钥。不要把密钥放在公开代码或消息里——任何拿到有效密钥的人都能消耗它绑定的额度。

密钥使用哪个额度?

| 工作区 | API 调用扣什么 | 谁能在应用中查看和管理密钥 | | Personal | 请求能被月度套餐额度完全覆盖时扣套餐额度,否则整笔请求扣已购额度,两者不会拆分 | 你自己创建、查看、命名和撤销密钥 | | Team plan | 创建密钥的成员在该团队的额度 | 成员各自创建和管理自己的密钥;有该角色时,Owner 和 admin 可以查看和管理所有成员的密钥,Created by 标明创建者 | | Enterprise Prepaid / API 工作区 | 组织的共享预付余额 | 成员可以创建密钥并查看工作区密钥列表;Owner 和 admin 拥有命名和撤销权限 | | 企业协议 | 组织的计费协议 | 成员可以创建密钥并查看工作区密钥列表;Owner 和 admin 拥有命名和撤销权限 |

切换工作区不会改变已有密钥的扣费额度,想用其他工作区请在那里新建密钥。团队额度和企业预付额度的机制不同,参见 Team Plan 和 Enterprise Prepaid。

编辑密钥名称

在 API Keys 中,点击活跃密钥行的 ⋯。

选择 Edit label,修改名称并保存。

标签只是帮你识别密钥,修改它不会更换密钥本身。

撤销密钥

在 API Keys 中,点击该密钥行的 ⋯。

选择 Revoke key。

阅读警告并点击 Revoke key 确认。

撤销立即生效且不可撤销(无法恢复)。使用该密钥的应用将失去 API 访问权限;如果应用需要持续运行,请先创建并部署替代密钥。

已撤销的密钥默认在列表中隐藏,开启 Show revoked keys 可查看。已撤销的密钥无法编辑或重新激活。

追踪用量

在 Settings 中,Usage 页面仅对 Enterprise 和预付 API 工作区的 Owner 和 admin 开放。个人账户和按席位计费的 Team 套餐没有这个页面。没有这个页面不代表你没有消耗额度,可以在用户菜单或 Wallet & Billing 中查看余额。

在 Ideogram Legacy 的 API 页面,Usage 仅对已配置用量报告的合格 Owner 和 admin 显示;普通成员和按席位计费的 Team 账号看不到。

如果你的工作区有 Usage 页面,按以下步骤操作:

选择要查看的工作区。

打开 Usage,或从概览页点击 Track your usage。

按应用或 API 来源、成员、API 密钥和日期范围筛选。

显示的日期范围使用 UTC。价格请查 Usage costs,账单和发票请看 Billing 或 Wallet & Billing。

可以查看哪些日期范围?

用量查询默认为 Last 30 days,时间范围菜单还提供 Month to date、Last 3 days 和 Last 90 days。Last 3 days 按小时分桶,其他范围按天分桶。与本地日历日期对比时注意 UTC 时间范围。

能否查看已撤销密钥的用量?

可以。用量筛选包含未激活或已撤销的密钥,排在活跃密钥之后。按密钥的部分值选中它,即可查看所选日期范围内归因到该密钥的用量。撤销密钥只是阻止后续认证,不会把它从用量筛选中移除。

查询用量价格

在 Settings 中打开 Usage costs,或在 Ideogram Legacy 的 API 页面打开 Pricing。

按模型名称、端点路径或工具搜索;清除搜索可回到完整列表。

某项操作提供 Rates and examples 或 Examples 时,展开可查看单价或示例计算。

需要时用 Show … older models and legacy endpoints 打开旧操作部分。

No matches 表示搜索无结果,试试更短的模型或工具名;Pricing unavailable 表示价目表加载失败,请重试后再用于成本估算。

请求格式和支持的参数请继续查看公开 API 文档。费用表帮你理解定价,但不能替代端点文档。

额度与计费

在个人工作区中,API 和应用共享你的额度余额。API 调用能被月度套餐额度完全覆盖时扣套餐额度,否则整笔扣已购额度。Team 套餐中,每个密钥使用创建者所在团队的额度。预付 API 工作区共享组织的钱包;企业协议按约定的计费条款执行。

举例来说,假设一次调用花费 20 额度(仅为示例):如果你还剩 50 点月度额度,就从套餐额度中扣 20 点;如果只剩 10 点,则 20 点全部从已购额度扣除,你的 10 点月度额度保持不变。

为充值的工作区打开 Settings 中的 Wallet & Billing,或 Ideogram Legacy API 页面的 Billing。计费操作仅限个人账户持有者或授权的组织管理者;团队成员请联系 Owner 为自己的席位充值。

购买流程参见 Buying Extra Credits、Enterprise Prepaid 和 Invoices, Receipts, and Tax Details。

在 Claude、ChatGPT 或 Cursor 中使用 Ideogram(MCP)

Ideogram MCP server 让 Claude、Claude Code、ChatGPT、Cursor、Cline 等 AI 助手和代理能够生成、编辑和放大图片、移除背景,以及用你的 Ideogram 账号训练自定义模型。客户端首次连接时需要登录你的 Ideogram 账号。各应用的配置步骤见 Use Ideogram in AI Assistants 和 Ideogram MCP 页面。MCP 的使用消耗所选工作区的额度:先扣套餐额度,再扣已购额度。

评论 (0)