集成指南
先完成最小调用,再将鉴权、请求状态与错误处理纳入自己的服务端请求层。
区分服务地址
| 地址 | 用途 |
|---|---|
| 平台网站 | 登录、密钥管理、模型选择与用量查看 |
| 文档网站 | 阅读接入指南与接口说明 |
| API 服务根地址 | 发起模型调用;由平台提供 |
不同协议的路径前缀可能不同。Seedance 原生路径为 /api/v3/contents/generations/tasks,不要额外拼接 /v1。
处理异步任务
提交任务后保存返回的 id。查询时设置间隔、最大次数与总超时;终态立即停止查询,页面离开或业务取消时也应停止本地等待。
防止重复提交
网络超时不代表服务端没有收到请求。再次提交前先检查已有任务记录,避免产生重复任务与重复计费。
处理错误
保留 HTTP 状态与错误响应。先处理鉴权、参数与权限问题,再考虑重试。对于限流和临时服务故障,可采用有次数上限的退避策略。
Webhook
当前核对到的接口定义未包含 Webhook 配置字段。现阶段请使用 任务查询,不要假设存在回调能力。

