常见问答
生图相关
用户生图卡住 / 失败 / 渠道挂掉 / 编辑结果不理想
用户报"生图一直转圈不出来"
多半是几个原因之一:
- 反向代理的问题 — Imagic 用流式输出渐进显示生图过程, 反代如果开了响应缓冲就会让用户觉得卡住。配置见 反向代理与 HTTPS, 关键是把 SSE 路径的缓冲关掉
- 上游本身就是慢 — 文生图 30-120 秒是正常的, 给反代的超时时间至少 5 分钟
- 服务异常重启 — 容器重启时正在跑的任务被打断, 系统会在 5 分钟内自动退点 + 标"已退回", 用户的点不会真的扣掉
用户报"生图失败但点数没退"
理论上不会出现。后台 → 生图历史搜这条记录, 状态应该是失败 / 已取消 / 已退回三者之一。 然后去 后台 → 积分流水 按这条记录搜, 应该有"冻结 + 退回"配对的两条记录。
如果真的没退点 (找不到退回记录), 进 后台 → 用户管理 给用户手工补点, 备注写清楚原因。 然后联系销售技术支持反馈这个 case, 一般是 bug 需要修。
后台显示"暂无可用渠道"
进 后台 → 渠道, 看每条渠道行末有没有"冷却到 X 点"这种提示。处理方式:
- 先看是不是上游服务商 (OpenAI / 你接的代理) 真的挂了 — 可以直接 curl 一下他们的 API
- 单条强制恢复: 把那条渠道切"禁用"再切回"启用", 系统会立刻清掉失败计数让它重新可用
- 如果你确定上游已经修好但冷却时间还没到, 同样用第 2 步立刻恢复
冷却时间会逐次递增 (第一次 1 分钟, 反复失败会到 1 小时), 任意一次成功就清零。
用户上传图片报"超过大小限制"
单图限制 10 MB, 一般够用。让用户用截图工具或图片压缩工具处理一下再传:
- 截图建议改成 JPG 而不是 PNG, 体积小很多
- 4K 大图先缩到 2K 再传, 模型用不到那么高分辨率
要支持大图传输需要二次开发, 联系销售技术支持。
编辑出来的图跟原图不太像 / 偏差大
这是 gpt-image-2 模型本身的特点, 不是 Imagic 的限制。教用户:
- 描述要写"保留 X, 改 Y"式的具体指令, 不要只描述目标
- 复杂场景用"局部重绘"(涂抹某块) 比直接编辑整图更可控
- 想保留人物 / 主体特征, 在描述里明确强调"keep the same character / pose / style"
文档站的 创造页 章节有详细使用建议, 可以让用户去看。
渐进出图变成"等很久突然全出来"
是渠道差异。你接的渠道里有 codex 反代类型, 这类渠道不支持渐进显示, 只能等整图出完。 要恢复渐进体验, 在 后台 → 渠道 把优先级最高的那条改成 OpenAI 兼容协议的渠道。
想限制某个用户疯狂生图
当前没有内置的"单用户每日生图次数"限制, 通过点数自然限制:
- 给用户设小额起始点数 (后台 → 设置 → 注册 → 默认点数)
- 涨价 (后台 → 计费) 让单张图扣点更多
- 实在过分的用户, 后台 → 用户管理 直接封禁
后续会增加更细的限流策略, 有需求联系销售。