跳转到主要内容
POST
/
kyyReactApiServer
/
kyyVideo2
/
asset
/
upload
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/upload \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "assetType": "Image",
    "url": "https://example.com/cat.jpg",
    "name": "猫咪图片"
  }'

{
  "code": 0,
  "msg": null,
  "data": {
    "assetId": "asset-20260330142158-q75m8"
  }
}

​
KyyVideo2 上传素材

上传素材到 KyyVideo2 素材库，获取素材 ID 用于视频生成任务。

​
认证

所有请求都需要在请求头中包含 Bearer token： 
Authorization: Bearer {{key}}

​
请求参数

​
assetType
string
必填
素材类型，首字母大写可选值：
  • Image - 图片
  • Video - 视频
  • Audio - 音频
  • Document - 文档
注意首字母必须大写
​
url
string
必填
素材的公网 URL 地址示例：https://example.com/image.jpg
​
name
string
素材名称，用于标识和管理素材示例：猫咪图片

​
响应参数

​
code
integer
响应状态码
  • 0 - 成功
  • 其他值 - 失败
​
msg
string
响应消息，成功时为 null，失败时返回错误信息
​
data
object
响应数据对象

​
素材类型说明

Image（图片）

支持格式：jpeg、png、webp、bmp、tiff、gif用于 referenceImages、first_image、last_image 参数

Video（视频）

支持分辨率：480p、720p用于 referenceVideos 参数

Audio（音频）

支持格式：wav、mp3用于 referenceAudios 参数

Document（文档）

文档类型素材用于其他场景

​
使用流程

1

上传素材

调用上传接口，获取 assetId
2

素材审核

涉及人脸或虚拟人像的素材需要等待审核通过
3

使用素材

在视频生成任务中使用 asset://{assetId} 格式引用素材
使用素材 ID 的优势：
  1. 素材经过审核，符合平台规范
  2. 素材存储在平台，访问速度更快
  3. 避免外部 URL 失效导致的问题
  4. 可以重复使用已上传的素材
最佳实践：
  • 为素材设置有意义的名称，便于管理
  • 涉及人脸的图片建议提前上传并等待审核
  • 保存好 assetId，可以在多个视频生成任务中重复使用
  • 确保素材 URL 在上传时可访问
curl --request POST \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/kyyVideo2/asset/upload \
  --header 'Authorization: Bearer {{key}}' \
  --header 'Content-Type: application/json' \
  --data '{
    "assetType": "Image",
    "url": "https://example.com/cat.jpg",
    "name": "猫咪图片"
  }'

{
  "code": 0,
  "msg": null,
  "data": {
    "assetId": "asset-20260330142158-q75m8"
  }
}