接入约定

• 固定传公开 model，不要传上游内部分支名。

• 视频传 seconds（注意各模型离散/固定/范围值）；分辨率优先用 tier，少依赖 size 字符串。

• 图生图 / 图生视频用 reference_images（注意张数与是否必填，见各模型页）。

• 模型专属参数放进 metadata（如 omni 的 first_last_frame / source_video_url）；用 OpenAI SDK 时通过 extra_body 传。

• 取结果只读查询响应里的 output_url（完成后才有），不要去猜上游字段。

• 任务异步，务必轮询；只按 status 终态结束。图片建议 3–5 秒、视频 5–10 秒一次。

• 参考图支持 https URL 或 base64 data URL（data: 前缀自动处理）。

> 拿到 API Key 即可开始 — 在控制台创建密钥后，把 base_url 指向 https://gsnails.xyz/v1。