Seedance 资产文档

Seedance 资产用于把图片、视频或音频 URL 注册为可在生视频请求中引用的素材。创建成功后，可在视频生成的 image_url.url、video_url.url、audio_url.url 中使用 asset://ASSET_ID 引用。

基础信息

项目	说明
Base URL	https://api.wisgate.cn
鉴权方式	Authorization: Bearer YOUR_API_KEY
请求格式	application/json
创建资产接口	POST /api/v3/open/CreateAsset
Action 风格入口	POST /api/v3/assets?Action=CreateAsset&Version=2024-01-01

对 SE 渠道，调用 CreateAsset 后，WisGate 会在内部提交上游资产创建请求并立即查询一次结果，把查询结果直接返回给调用方；通常不需要再单独轮询资产状态。

创建资产

curl --location --request POST 'https://api.wisgate.cn/api/v3/open/CreateAsset' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Name": "product-role",
    "Url": "https://example.com/product-role.png",
    "AssetType": "Image"
  }'

也可以使用 Action 风格入口：

curl --location --request POST 'https://api.wisgate.cn/api/v3/assets?Action=CreateAsset&Version=2024-01-01' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "Name": "product-role",
    "Url": "https://example.com/product-role.png",
    "AssetType": "Image"
  }'

请求参数

参数	类型	必填	支持情况	说明
Name	string	是	支持	素材名称，建议不超过 20 个字符
Url	string	是	支持	素材 URL。兼容传入 URL，WisGate 会转换为 Url
AssetType	string	否	支持	素材类型：Image、Video、Audio

响应示例

{
  "Status": "succeed",
  "ErrorCode": "",
  "ErrorMessage": "",
  "AssetId": "asset-20260430111413-7mv94",
  "RequestId": "req-xxx"
}

字段	说明
Status	pending 表示处理中，succeed 表示成功，failed 表示失败
AssetId	成功后返回的素材 ID，可在视频生成请求中按 asset://ASSET_ID 引用
ErrorCode / ErrorMessage	失败时返回的错误码和错误信息
RequestId	请求追踪 ID

在视频任务中引用

{
  "model": "doubao-seedance-2",
  "content": [
    {
      "type": "text",
      "text": "参考资产中的主体，生成一段自然运动的视频。"
    },
    {
      "type": "image_url",
      "role": "reference_image",
      "image_url": {
        "url": "asset://asset-20260430111413-7mv94"
      }
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

注意事项

• 图片、视频、音频素材应使用公网可访问 URL。
• 如果素材会被多个任务复用，建议先创建资产，再用 asset://ASSET_ID 引用。
• 资产创建失败时，请优先检查素材 URL 是否可访问、类型是否与 AssetType 一致。
• 生成视频结果中的 URL 通常有有效期；资产引用并不等同于业务侧永久存储。
• 如果返回 pending，通常表示上游仍在处理素材；建议稍后重试创建或直接在视频任务中使用可访问 URL。