用途:为文生图工作流显式选择当前 Ideogram 生成路线,覆盖 V4 同步、V4 异步、透明变体与 P-Image 同步/异步,避免应用继承过时旧端点,或把同步与异步生命周期当作等价。
主要能力:按延迟、透明度、提示词形式与模型需求选择最小生成面;区分同步与异步处理;构建端点专属 multipart 载荷并拒绝互斥或不支持字段;限制输出数量、输入大小、渲染选项、并发与总时限;对返回图像做安全校验并立即持久化(厂商 URL 会过期);异步任务持久化 generation_id,幂等对账 webhook 与轮询,仅在识别到终态时结束;记录路线、策略、花费、安全、存储与清理证据。
使用方式:认证仅通过 Api-Key 头把服务端 IDEOGRAM_API_KEY 发往 https://api.ideogram.ai,绝不把密钥或付费生成权限暴露给浏览器或不可信租户。V4 接受文本或结构化 JSON 提示,JSON 提示会禁用 magic prompt;V4 FLASH 当前返回 400。仅当请求截止时间能安全覆盖生成与立即下载时才用同步,否则用异步。用 Read、Glob、Grep 检查需求、适配器与夹具,用 Write、Edit 做已批准的实现或文档变更;仅调用本技能不执行实际生成、不上传客户内容、不改动生产流量。
适用场景:交互式不透明图像走 V4 同步,批量活动走 V4 异步;无背景目录素材在存储与审核就绪后走透明端点。
限制:付费调用、敏感提示或图像、对外发布、模型或渲染变更、版权检测策略变更与生产上线均需审批;路线迁移需金丝雀与可回滚流量控制。400、401、422、429 按类别处理,验证与认证失败不重试;is_image_safe=false 与空 URL 视为已完成的策略结果而非传输失败。依赖前需复核端点专属页面与当前 OpenAPI 描述,枚举、限制、测试功能与生命周期声明以第一方文档为准。