Skip to main content
POST
https://www.geeknow.top
/
api
/
asset
/
createMedia
curl -X POST https://www.geeknow.top/api/asset/createMedia \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/assets/product-reference.png",
    "name": "product-reference.png",
    "assetType": "image"
  }'

{
  "ResponseMetadata": {
    "Action": "seedance2"
  },
  "Result": {
    "Id": "asset-20260528143012-a8x7k",
    "Name": "product-reference.png",
    "URL": "https://example.com/assets/product-reference.png",
    "AssetType": "image",
    "Status": "Processing"
  }
}

​
Seedance-2 创建素材

这个接口把一个公网素材 URL 注册到素材库，并返回后续视频生成可引用的素材 ID。
  • 使用异步处理模式，创建后返回素材 ID 和 Processing 状态
  • 通过 assetType 区分图片、视频和音频素材
  • 创建成功后可用 GET /api/asset/get 查询素材是否变为 Active
  • 生成视频时可把 Result.Id 拼成 asset://{asset_id}，用于首帧、尾帧、参考图、参考视频或参考音频字段

​
方法与路径

POST /api/asset/createMedia

curl -X POST https://www.geeknow.top/api/asset/createMedia \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/assets/product-reference.png",
    "name": "product-reference.png",
    "assetType": "image"
  }'

​
assetType 枚举怎么理解

assetType 用来告诉接口：这个 url 应该按哪种素材处理。你只需要传一个 url，不需要自己传 imageUrls、videoUrls 或 audioUrls。
assetType含义等价素材列表常见用途
image图片素材imageUrls: [url]首帧图、尾帧图、参考图
video视频素材videoUrls: [url]参考视频、镜头运动参考
audio音频素材audioUrls: [url]背景音乐、参考音频
例如你传入： 
{
  "url": "https://example.com/assets/camera-motion.mp4",
  "assetType": "video"
}
它表达的含义是：https://example.com/assets/camera-motion.mp4 是一个视频素材，等价于把这个地址放进视频素材列表： 
{
  "videoUrls": ["https://example.com/assets/camera-motion.mp4"]
}
同理，如果 assetType 是 image，同一个 url 会按图片素材处理；如果是 audio，同一个 url 会按音频素材处理。

​
素材 ID 与引用 URI

素材创建成功后，响应里的 Result.Id 是素材 ID，例如 asset-20260528143012-a8x7k。这个值有两种用法：
场景写法示例
查询素材状态直接使用素材 IDGET /api/asset/get?id=asset-20260528143012-a8x7k
在视频生成里引用素材加上 asset:// 前缀"first_image": "asset://asset-20260528143012-a8x7k"
asset://asset-20260528143012-a8x7k 表示“引用素材库中这个 ID 对应的素材”。它不是公网 URL，不能直接在浏览器中打开；如果需要查看素材原始地址或当前状态，使用 查询素材。 常见写法： 
{
  "model": "seedance-2.0-pro",
  "prompt": "让首帧图中的人物自然转身，看向镜头",
  "duration": 6,
  "aspect_ratio": "9:16",
  "first_image": "asset://asset-20260528143012-a8x7k"
}
多参考素材也使用同样的 URI 写法： 
{
  "reference_images": ["asset://asset-20260528143012-a8x7k"],
  "reference_videos": ["asset://asset-20260528143708-k9m2p"],
  "reference_audios": ["asset://asset-20260528144123-r4s6n"]
}

​
响应示例

{
  "ResponseMetadata": {
    "Action": "seedance2"
  },
  "Result": {
    "Id": "asset-20260528143012-a8x7k",
    "Name": "product-reference.png",
    "URL": "https://example.com/assets/product-reference.png",
    "AssetType": "image",
    "Status": "Processing"
  }
}

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
url
string
required
素材公网 URL。必须是服务端可访问的地址，例如 https://example.com/assets/product-reference.png。
​
name
string
素材名称。建议传入带扩展名的文件名，例如 product-reference.png、camera-motion.mp4 或 background-music.mp3。
​
assetType
string
素材类型。支持 image、video、audio；未传时按 image 处理。建议始终显式传入，避免视频或音频 URL 被当作图片素材。

​
Response

​
ResponseMetadata
object
请求元信息。Seedance-2 素材接口通常会返回 Action。
​
Result.Id
string
素材 ID，例如 asset-20260528143012-a8x7k。查询素材时直接传这个 ID；在视频生成请求中引用素材时写成 asset://asset-20260528143012-a8x7k。
​
Result.Name
string
素材名称。通常来自请求里的 name。
​
Result.URL
string
原始素材 URL。
​
Result.AssetType
string
素材类型，通常与请求里的 assetType 一致。
​
Result.Status
string
素材状态。常见值为 Processing、Active、Failed。

​
使用场景

​
创建参考图片素材

把商品图、角色图、场景图等注册为 image 素材，后续在视频生成请求中作为首帧、尾帧或参考图使用。 
{
  "url": "https://example.com/assets/character.png",
  "name": "character.png",
  "assetType": "image"
}

​
创建参考视频素材

把一段镜头运动、构图或动作参考注册为 video 素材，后续作为参考视频使用。 
{
  "url": "https://example.com/assets/motion-reference.mp4",
  "name": "motion-reference.mp4",
  "assetType": "video"
}

​
创建参考音频素材

把背景音乐、口播或氛围音注册为 audio 素材，后续作为参考音频使用。 
{
  "url": "https://example.com/assets/theme.mp3",
  "name": "theme.mp3",
  "assetType": "audio"
}

​
注意事项

  • /api/asset/createMedia 只接收一个 url；不要把 imageUrls、videoUrls、audioUrls 直接作为请求字段传入。
  • assetType 是大小写敏感的公开参数，推荐使用小写的 image、video、audio。
  • 创建成功只代表素材任务已提交。使用前建议调用 查询素材 确认 Result.Status 已变为 Active。
  • 查询素材时使用裸素材 ID，例如 asset-20260528143012-a8x7k；视频生成字段中引用素材时使用 asset://asset-20260528143012-a8x7k。
  • 如果素材 URL 无法访问、下载超时或格式不被上游接受，素材状态可能变为 Failed。

​
相关页面