用途：通过 Ideogram 官方 Developer API 完成图像生成与编辑任务，涵盖生成、异步生成、混合（remix）、局部重绘（inpaint）、重构（reframe）、替换背景、抠图、文字分层、图像描述与放大。
主要能力与路由：文本/版式生成走 POST /v1/ideogram-v4/generate，异步版本为 POST /v1/ideogram-v4/async/generate，可用 GET /v1/generations/{generation_id} 轮询；V4 还支持 /v1/ideogram-v4/remix、/magic-prompt、/describe。V3 提供 /v1/ideogram-v3/generate、generate-transparent、inpaint、remix、reframe、replace-background、layerize-text。另有 POST /v1/remove-background、POST /v1/edit、POST /upscale、POST /describe，以及自定义模型相关数据集与训练接口。不要向 V4/V3 路由发送 model 字段，其版本由路径段表示。
使用方式：基址为 https://api.ideogram.ai，密钥仅通过 Api-Key 请求头发送。多数操作为 multipart/form-data，V4 Magic Prompt 用 JSON。成功返回的是图片 URL 而非字节，链接会过期且未公布固定时长，需立即下载。V4 分辨率与 V3 宽高比、风格预设均为固定枚举，须按官方 schema 校验；V4 文本排版建议使用 json_prompt 精确放置文字，V3 可用 style_preset、风格引用、角色引用与 Remix 的 image_weight。局部重绘要求掩码与输入同尺寸，可编辑区域标记为黑色。
限制：模型可用性、端点生命周期、价格、限额与策略均属易变信息，发布前应重新核对官方文档、OpenAPI、定价与政策。V4 目前对 FLASH 返回 400，透明背景生成也不接受 FLASH。上传图片一般为 JPEG/PNG/WebP 且不超过 10 MB；/v1/edit 最多 10 张、每张 10 MB。自定义模型训练契约要求 15–100 张图片，但官方教程称 10 张即可，存在冲突；训练成本约为 40 美元（资料原文数值，需核实）。密钥仅在创建时完整显示一次，应使用密钥管理器并避免记录日志。
适用场景：需要程序化生成带文字版式的海报、营销素材，或对已有图片做局部修改、换背景、扩图、描述转提示词的开发与自动化流程。
暂未提供：官方未公布图片链接具体有效期、输出格式选择器、提示词最大长度、字体目录及拼写准确率的服务保证。