Q501：生图模型可以使用 chat.completions 接口调用吗？
不能。文生图与参考图生成必须调用专用的图像生成端点：
Q502：图生图（参考图）返回 500 或 404（Image unreachable）如何解决？
该报错通常是由于模型服务端无法成功拉取参考图所致（本地浏览器能打开，并不代表云端推理节点能够直接下载）。 请按以下关键点排查参考图 URL：- 公网免密可达：必须为公网可直接访问的链接，不能使用
localhost、局域网内网地址（如192.168.*、10.*）或依赖特定登录态/Cookie 的私有页面； - 标准 HTTPS 协议：建议使用公网对象存储（如 OSS / S3 / CDN）的标准 HTTPS 链接，避免携带非标端口号（如
:8080、:5000）或触发防盗链拦截； - 预签名链接有效期：若使用云存储的临时签名链接（Pre-signed URL），请设置充足的有效时长，避免因上游排队生图导致拉取时签名已过期；
- 直链有效性核对：确保 URL 直接指向真实的图片文件（JPG/PNG/WEBP 等），而非 HTML 登录页、中转页或错误重定向页面。
Q503：生图请求耗时较长（1~3 分钟），如何避免前端页面超时卡死？
生图任务属于重算力任务，强烈推荐采用 “异步任务队列” 架构：- 前端提交请求至业务服务端，服务端生成 Task ID 并即时返回前端；
- 服务端工作进程异步调用生图 API；
- 前端通过轮询 Task ID 状态或通过 WebSocket 接收完成通知；
- 业务侧 SDK、反向代理与 Worker 的
timeout应设置为 180 秒以上，并在确认上一请求状态前关闭自动盲目重试，防止重复生成扣费。