跳转到主要内容

请注意:如果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:// 引用。
三种接口格式功能相同、数据互通,按你的客户端选一种即可。也可以使用 v1 接口 或 火山标准 REST。

鉴权

string
必填
本平台的 API Key,在 API 密钥 页面创建。也可以改用 Authorization: Bearer <API Key>。
使用火山 SDK 时,把服务地址改成 api.nodylink.com,并在请求头中加上 x-api-key。SDK 用 AK/SK 生成的 HMAC 签名会被忽略,AK/SK 不会被校验。

公共参数

string
必填
操作名,见 接口一览。
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 中。
  • 素材 ID 只能在本平台的 Seedance 视频生成中使用。
  • 素材详情里的 URL 是会过期的签名地址,请保存素材 Id,不要保存 URL。

错误响应

错误放在 ResponseMetadata.Error 中,没有 Result:
API Key 无效时由网关统一返回,使用 OpenAI 风格的错误体 {"error": {"message": "...", "code": "..."}},格式见 错误码。处理错误时请同时兼容两种结构。
素材管理接口上线前通过旧版接口创建的素材没有账户归属记录,查询、更新、删除时会返回 403,但仍可在视频生成中通过 asset://<Id> 引用。