Skip to main content
GET
https://www.geeknow.top
/
api
/
asset
/
get
curl -X GET "https://www.geeknow.top/api/asset/get?id=asset-20260528143012-a8x7k" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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 查询素材

这个接口用于查询通过 POST /api/asset/createMedia 创建的素材。
  • 根据素材 ID 查询素材详情
  • 返回素材 URL、类型和状态
  • 可用于确认素材是否已从 Processing 变为 Active
  • 查询接口使用裸素材 ID；视频生成接口使用 asset://{asset_id} 引用素材

​
方法与路径

GET /api/asset/get?id={asset_id}

curl -X GET "https://www.geeknow.top/api/asset/get?id=asset-20260528143012-a8x7k" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
从素材 ID 到视频生成引用

GET /api/asset/get 的 id 参数只接收素材 ID 本身，例如 asset-20260528143012-a8x7k。不要在查询接口里加 asset:// 前缀。 当 Result.Status 为 Active 后，可以把同一个素材 ID 拼成 asset://{asset_id}，传给视频生成接口中的素材字段。
目的字段示例
首帧生视频first_image 或 first_frame_url"first_image": "asset://asset-20260528143012-a8x7k"
尾帧约束last_image 或 last_frame_url"last_image": "asset://asset-20260528143351-b2n6q"
参考图片reference_images 或 reference_image_urls"reference_images": ["asset://asset-20260528143012-a8x7k"]
参考视频reference_videos 或 reference_video_urls"reference_videos": ["asset://asset-20260528143708-k9m2p"]
参考音频reference_audios 或 audio_url"reference_audios": ["asset://asset-20260528144123-r4s6n"]
{
  "model": "seedance-2.0-pro",
  "prompt": "参考素材中的产品外观和镜头运动，生成一条广告感短视频",
  "duration": 6,
  "aspect_ratio": "adaptive",
  "reference_images": ["asset://asset-20260528143012-a8x7k"],
  "reference_videos": ["asset://asset-20260528143708-k9m2p"]
}

​
响应示例

{
  "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

​
Query Parameters

​
id
string
required
素材 ID，例如 asset-20260528143012-a8x7k。这里使用裸 ID，不要传 asset://asset-20260528143012-a8x7k。

​
Response

​
ResponseMetadata
object
请求元信息。
​
Result.Id
string
素材 ID。用于查询时保持裸 ID；用于视频生成素材字段时拼成 asset://{Result.Id}。
​
Result.Name
string
素材名称。
​
Result.URL
string
素材 URL。
​
Result.AssetType
string
素材类型。常见值为 image、video、audio。
​
Result.Status
string
素材状态。常见值为 Processing、Active、Failed。

​
使用场景

​
创建素材后确认状态

创建素材接口返回 Processing 后，使用素材 ID 查询，直到 Result.Status 变为 Active。 
GET /api/asset/get?id=asset-20260528143012-a8x7k

​
检查素材类型

读取 Result.AssetType，确认素材是否按预期注册为 image、video 或 audio。 
{
  "Result": {
    "AssetType": "video",
    "Status": "Active"
  }
}

​
注意事项

  • id 必须来自素材创建接口返回的 Result.Id。
  • GET /api/asset/get 的 id 参数不要带 asset:// 前缀。
  • Processing 表示素材仍在处理，建议等待 Active 后再用于视频生成。
  • Failed 表示素材处理失败，需要重新检查原始 URL、文件格式或上游限制。

​
相关页面