限制与生产接入建议
本站提供统一入口，但不同模型并不因此具备相同能力。新增接入应先选择型号，再按相应章节构造请求。
兼容边界
| 能力 | 边界与做法 |
|---|---|
| 视频参数 | Grok、Mini/Fast、SD、H3 的时长、分辨率、素材格式分别校验，不能共用一个固定参数模板 |
| 视频参考图 | 普通参考图、首帧和首尾帧语义不同，遵守型号的互斥规则 |
| 视频计费 | 按次、按秒、视频 Token 分别计算 |
| 图片异步 stream=true | 不提供可靠的图片 SSE 终态解析，使用非流式任务结果 |
| 异步 b64_json | 结果通常转为托管 URL，客户端兼容少数 Base64 结果 |
| 多图 n>1 | 部分失败与计费更复杂，示例固定 n=1，分别跟踪任务 |
| 幂等提交 | 没有全型号统一可依赖的 Idempotency-Key 保证，在业务端去重 |
| completed | 仍需校验结果非空、下载成功、媒体可解码 |
| 任务取消 / 回调 | 没有本手册承诺的统一取消 API 或统一 webhook，使用有界轮询 |
| 任务保留 | 结果有保留期，及时转存；图片任务不保证跨重启恢复 |
| 浏览器接入 | Key 放自己的后端，不在网页源码或浏览器存储中分发 |
| 历史型号 | 当前目录未列出的旧型号不作为新接入默认值 |
超时、重试和业务去重
区分提交连接超时、一次 GET 超时、客户端总等待期限。图片示例提交 60 秒，视频示例提交 120 秒，查询 30 秒，总等待 30 分钟；这些是客户端配置，不是服务 SLA。
提交前先持久化自己的业务唯一 ID 和“正在提交”状态。收到 task_id 立即记录。POST 超时且没有 ID 时标记“提交结果未知”，先核查记录；不要让 SDK、反向代理、作业队列自动重放生成请求。
只对 GET 的网络故障、429 和临时 5xx 做有界退避。使用原 ID 恢复等待，绝不因为下载失败重新生成。批量任务从小并发开始，加入轮询抖动，按 429 调整。
凭据和结果下载
- 查询任务只使用固定本站 HTTPS origin 与合法 task_id，不能信任任意 poll_url 然后向其转发 Key。
- 视频 /content 入口需要 Key；图片托管直链与外部媒体 URL 不携带本站 Key。
- 禁止携带 Key 自动跨站重定向。原始响应中的临时签名 URL 也不写进公共日志。
- 下载到临时文件，校验 HTTP、文件头、大小与真实解码，再原子替换正式结果。
- 生产系统记录公开型号、参数摘要、任务 ID、实际媒体规格、哈希与费用，避免仅保存页面截图。
SDK 和工作流适配
普通 OpenAI Images 客户端通常期待同步 data[]。本站 /async 的任务对象需要你实现“创建、保存 ID、轮询、终态、下载”，只修改 Base URL 不会自动完成这些步骤。
视频使用本手册明确给出的 JSON 与原始 HTTP 路径；第三方 SDK 的专有对象不一定与所选型号参数一致。禁用会自动重发生成 POST 的重试配置。若工具不支持任务对象，可自行增加服务端任务队列和轮询组件。
上线前检查
用当前 Key 确认目录和分组；校验参数；对业务提交去重；模拟失败、结果未知、GET 暂时失败和下载中断；确认日志脱敏；配置临时资源转存与账单核对。
先在自己的业务中选少量目标规格验证实际生成，再逐步放量。本手册的契约校验不能替代对全部提示词、画面、规格的生成质量验收。
当前图片接入差异
MJ只接受本页约定JSON，size用比例、quality用数值，n=1返回多张，原生MJ后续按钮未开放。Seedream用resolution档位加size比例，Lite与Pro上限不同。GPT/Gemini常用像素size；Adobe中质量统一medium，支持明确4K并按可用规格分流，不自动降成2K。参见MJ、Seedream、GPT图片、香蕉。
不能仅凭模型广场显示某种通用endpoint标签，断定所有SDK参数或原生操作都能调用。优先使用对应专章的已确认入口。