请注意:如果Seedance生成请求中未创建素材,后台将为其自动创建素材再提交任务。因此若无需素材管理则生成请求中直接传公网URL即可。
- 请求格式与火山引擎 OpenAPI 一致:
POST https://api.nodylink.com/?Action=<Action>&Version=2024-01-01,请求体为 JSON,字段使用 PascalCase。 - 成功响应为
{"ResponseMetadata": {...}, "Result": {...}},错误放在ResponseMetadata.Error中。 - 用
x-api-key请求头传本平台的 API Key。火山 SDK 自动附带的 HMAC 签名会被忽略,只带签名会返回 401。 - 创建素材必须传
GroupId,请先 创建素材组。 - 素材按账户隔离:同一账户下的所有 API Key 共享素材组和素材,其他账户无法访问。
- 创建素材是异步的:接口立即返回素材
Id,请每 2 秒 查询素材 一次,直到Status为Active,然后在视频生成中 通过 asset:// 引用。
鉴权
使用火山 SDK 时,把服务地址改成api.nodylink.com,并在请求头中加上 x-api-key。SDK 用 AK/SK 生成的 HMAC 签名会被忽略,AK/SK 不会被校验。
公共参数
string
必填
固定为
2024-01-01。ResponseMetadata:
接口一览
素材组
素材组用于归类素材。素材组和组内素材只对创建它的账户可见。创建素材组
POST /?Action=CreateAssetGroup&Version=2024-01-01
200
Result.Id,后续操作通过它指定素材组。
列出素材组
POST /?Action=ListAssetGroups&Version=2024-01-01
列出当前账户创建的素材组,最新创建的排在前面。请求体可以为空。
200
查询素材组
POST /?Action=GetAssetGroup&Version=2024-01-01
200
更新素材组
POST /?Action=UpdateAssetGroup&Version=2024-01-01
Name 和 Description 至少传一个,只更新传入的字段。
200
删除素材组
POST /?Action=DeleteAssetGroup&Version=2024-01-01
200
素材
创建素材
POST /?Action=CreateAsset&Version=2024-01-01
把公网素材登记到指定素材组,立即返回素材 Id,不等待处理完成。
200
支持格式与限制
素材 URL 必须是公网直链,无需登录即可直接下载,建议使用 HTTPS。不支持本地文件上传,也不支持
data: 格式的 Base64 数据。
查询素材
POST /?Action=GetAsset&Version=2024-01-01
创建后素材可能仍在处理。建议每 2 秒查询一次,直到 Status 为 Active。
200
处理状态
列出素材
POST /?Action=ListAssets&Version=2024-01-01
列出指定素材组内的素材。
200
更新素材
POST /?Action=UpdateAsset&Version=2024-01-01
目前只支持修改素材名称。
200
删除素材
POST /?Action=DeleteAsset&Version=2024-01-01
200
Result 可能为空对象,也可能带 Id,请以 HTTP 200 判断成功。删除后再访问该素材会返回 403 seedance_asset_forbidden。
在视频生成中使用
素材变为Active 后,在 Seedance 视频生成 请求的 content 中,把对应的 URL 写成 asset://<Id>:
video_url.url 和 audio_url.url 中。
错误响应
错误放在ResponseMetadata.Error 中,没有 Result:
API Key 无效时由网关统一返回,使用 OpenAI 风格的错误体
{"error": {"message": "...", "code": "..."}},格式见 错误码。处理错误时请同时兼容两种结构。素材管理接口上线前通过旧版接口创建的素材没有账户归属记录,查询、更新、删除时会返回 403,但仍可在视频生成中通过
asset://<Id> 引用。
