用途:把付费图像生成控制在可度量的并发范围内,防止流量突发演变为重复花费、无界队列或持续的 429 压力。
主要能力:账户级共享信号量(低于已验证上限)、按租户的有界准入与队列长度/年龄限制、输出数量与总操作截止时间、端点感知的重试策略(指数退避加抖动、严格尝试上限)、异步端点与 generation_id 持久化、重复生成抑制。
必要用法:工作进程在服务端注入 IDEOGRAM_API_KEY,仅向 https://api.ideogram.ai 发送 Api-Key;队列记录与指标须排除密钥、提示词、图像和响应 URL。先测量到达率、各端点服务时间、当前在途数、队列年龄、超时率与 429 数;将共享信号量设在验证上限之下并保守起步,为恢复探测预留容量。无法满足交互截止时间的工作优先走异步端点。仅在分类为瞬态响应时重试,重提交前先核对已知异步标识符。
限制:Ideogram API 概览记载默认 10 个在途请求,更大容量需联系 partnership@ideogram.ai;这是并发边界,不代表每进程可启动十个工作进程,账户实际观测行为才是权威。429 是准入控制信号,立即重试会放大压力;400、401、422、不安全输出或已接受的异步提交不应按瞬态重试。过期队列工作应在调用 Ideogram 之前终止。提高容量须经厂商路径与评审过的负载计划,并做金丝雀验证。实时负载测试、花费、租户优先级变更、队列丢弃、容量提升与部署均需负责人审批。
验证:先用确定性队列模拟器验证公平性与截止过期,注入 429 与超时结果,证明重复抑制;仅在批准的请求与成本上限内做付费负载检查。