用途：把 Ideogram 的传输行为封装在应用自有的小接口后面，保留各端点的 multipart 契约、错误体、安全结果、异步标识与存储交接，避免业务逻辑耦合原始供应商载荷。
主要能力：盘点所需端点族并固定其当前 schema；定义自有请求类型，使 text_prompt 与 json_prompt 等互斥字段无法同时出现；集中管理主机、认证、超时、响应字节上限、错误解码与 content-type 检查；保留供应商状态、请求或生成标识、is_image_safe 及用于漂移审查的未知字段；分离提交、轮询、webhook 对账、资产下载与持久存储接口；仅对分类为瞬时的失败做有界抖动重试并设操作截止时间，不盲目重放不明确的写入。
使用方式：认证上仅在可信传输适配器内注入 IDEOGRAM_API_KEY，并以 Api-Key 发送到 https://api.ideogram.ai；日志与异常中需脱敏请求头、multipart 内容、提示词、图像输入、响应 URL 与二进制体。用 Read、Glob、Grep 识别现有客户端与调用点，用 Write、Edit 仅做已批准的适配器、类型、测试或文档改动。
适用场景：构建或审查应用对 Ideogram 的集成，需要端点映射、重试与截止策略、兼容性风险与回滚计划时。
限制：资料未提供具体语言、依赖或价格信息；不得把第三方包或本地封装当作官方 SDK；添加依赖、改变重试语义、暴露新提示或图像字段、切换端点、启用付费流量或改动持久存储前需评审；对意外 content-type、超大下载、不安全输出或未识别终态应失败关闭。