规划 Seedream API 接入

选择生成或参考图编辑

新构图选择文生图，需要现有图片引导结果时选择参考图编辑。核实服务商提供的 Seedream 版本、支持的参考图输入和参数。系列名称本身不等于可调用端点。

在任务记录中保留真实模型标识，不要在失败后未经明确选择自动换用其他模型。网站账户与服务商直连凭证分别管理。

从服务端提交请求

将服务商凭证保存在服务端。提交前校验提示词、参考图授权、支持的参数和账户权限，并设置限流与消费上限。

下方是不可直接执行的检查清单。真实模型 ID 与请求结构请查阅服务商当前文档，不要在前端、示例或截图中泄露有效凭证。

# Seedream integration checklist (not an executable request)
model_id: MODEL_ID_FROM_YOUR_PROVIDER
operation: text-to-image OR reference-edit
prompt: Your complete creative brief
references: Your permitted input image URLs, when required
settings: Only options documented for the selected model

# Keep credentials on your server. Confirm endpoint, availability,
# input limits and the live quote before submitting a billable task.
# Save the task ID and poll its status; do not repeat an ambiguous POST.

把生成当成队列任务

提交成功后保存供应商请求标识。按合理间隔查询状态，完成后再获取结果。签名 webhook 可以减少轮询，但更新任务或计费状态前必须验证来源。

临时网络失败后可以重试安全的状态查询。提交结果不明时不要盲目重发，重复请求可能创建两个计费任务。将供应商请求标识与应用任务、积分交易关联，方便排查。

校验输出设置与参考图片

只使用所选接口支持的设置。固定需要的文件格式与画幅，不要原样转发任意浏览器字段。接收图片 URL 时校验协议与长度，并控制应用能够访问的存储位置。

需要长期访问时，将最终图片保存到你控制的存储。返回任务状态，不要在整个生成期间一直占用 HTTP 请求。开放付费访问前测试失败、超时和取消路径。