# SD2 API

## API Docs
- direct-integration [创建视频任务](https://doc.seedance.show/442160085e0.md): 统一创建入口。虽然上游文档常把文生视频、首帧生视频、首尾帧生视频、多模态参考生成分开展示，当前代理程序仍统一使用这一条接口收口。
- direct-integration [查询任务](https://doc.seedance.show/442160086e0.md): 返回的是代理侧最小状态集：`id`、`status`、`provider_task_id`、`queue_position`。 这不是上游原生查询结果；不会直接返回 `video_url`、`usage.total_tokens` 或完整上游 body。
- health [Web 进程健康检查](https://doc.seedance.show/442160088e0.md): 公开健康检查。适合做最小在线探测，但它只证明当前 Web 入口能响应请求，不证明上游生成、上传服务或 OIDC 一定全部正常。
- web-session-uploads [获取浏览器直传临时素材的 presigned URL](https://doc.seedance.show/442160093e0.md): 登录态临时上传授权接口。通常流程是：先拿 `uploadUrl` 直传素材，再把 `publicUrl` 提交给 `/api/me/assets` 做素材登记，最后在生成请求里引用登记后的 `asset://<asset_id>` 或直接使用临时 URL。
- web-session-assets [当前登录用户素材列表](https://doc.seedance.show/442160089e0.md): 已登录用户查看素材登记结果。`myAssets` 是自己的素材，`sharedAssets` 仅在当前登录用户具备共享素材库查看权限时返回。 若要在生成请求中使用共享素材，请从这里读取 `assetId` 并组装为 `asset://<assetId>`。
- web-session-assets [当前登录用户提交共享素材](https://doc.seedance.show/442160090e0.md): 已登录用户登记素材。通常把 `/api/uploads/presign` 返回并已上传成功的 `publicUrl` 提交到这里；若 preview 生成成功，后续列表接口会返回预览图信息。成功后返回 `asset_id`。
- web-session-assets [删除当前登录用户自己的素材](https://doc.seedance.show/442160092e0.md): 已登录用户删除自己的素材记录。删除的是当前代理侧素材记录及其关联预览，不等于回收已生成视频任务中的历史引用。