耗时、并发与重试

生图是长耗时请求

图片生成接口对客户端表现为同步调用：发送一次请求，等待最终图片结果。本轮单张 1K 联调约需 28～30 秒，历史调用也出现过更长耗时。这些是样例观测，不是 SLA 或耗时上限。本文示例使用：

请同时检查你的 SDK、业务服务、反向代理、负载均衡和应用前端。只提高 HTTP 客户端超时，并不能解决中间代理提前断连的问题。

模型调用使用 https://api.vizluma.online/v1。不要将控制台域名 sub.vizluma.online 或文档域名 docs.vizluma.online 配置为模型 Base URL。

下列情况都不保证服务端未执行生成：

对于已经提交的异步生成任务，请求结束后任务仍可能继续完成并结算。请先查看调用记录；无法判断时，向对接人员提供时间、模型和请求 ID。

当前文档不提供可供客户端依赖的生图幂等键或按幂等键查询结果的保证。不要假设重复发送相同请求会自动去重，也不要为生图创建请求开启无条件重试。

情况	建议
`400` 参数错误	先修正参数，不重复发送原请求
`401` / `403`	检查凭证、额度与权限，再决定是否重新提交
`429`	降低并发、按提示等待；不能确认是否提交成功时先核对记录
`5xx` / 超时 / 断连	先确认执行状态，再决定是否重试
图片下载失败，但生成已成功	优先重试下载，不要重新生图

不要将“网关接受 n 最大为 10”理解为“允许无限并发”。n 是单次请求的图片数，并发是同时进行的请求数。当前不承诺不限速、不限并发或已具备严格的客户级并发隔离。生产调用量、峰值并发、排队策略和批量支持，请在企业开通时确认；业务端应使用有界队列控制并发。