POST https://art-api.yuyuflow.com/?Action=CreateAsset&Version=2024-01-01

在指定的 Asset Group（素材资产组合）内传入 Asset（素材资产）。

注意

上传素材 （CreateAsset） API 为异步接口，系统处理可能出现排队，导致入库时间增加。不承诺上传时间 SLA。

视频类素材处理时间更长。

鉴权说明

本接口仅支持 Access Key（AK/SK）鉴权。

请求参数​

请求体​

GroupId string

Asset（素材资产）所属的 Asset Group（素材资产组合）的 Id。

URL string

传入的 Asset（素材资产）的公共可访问地址（URL）。

Name string

Asset（素材资产）的名称，上限为 64 个字符。

注意：该字段仅用于使用 ListAssets 接口时模糊搜索素材，不会被带入模型推理。关于如何使用素材生成视频，请参考使用人像素材生成视频和常见问题 4。

AssetType string

Asset（素材资产）的类型，支持传入图像、视频、音频。可选值：

  • Image：图像

  • Video：视频

  • Audio：音频

说明

传入图像、视频、音频素材时，仅支持上传 URL，不支持 Base64。

说明

  • 格式：jpeg、png、webp、bmp、tiff、gif、heic、heif

  • 宽高比（宽/高）：(0.4, 2.5)

  • 宽高长度（px）：(300, 6000)

  • 大小：单张图片小于 30 MB

说明

  • 格式：mp4、mov

  • 分辨率：480p、720p、1080p

  • 时长：单个视频时长 [2, 15] s

  • 尺寸：

    • 宽高比（宽/高）：[0.4, 2.5]

    • 宽高长度（px）：[300, 6000]

    • 总像素数：宽×高 ∈ [409600, 2086876]

  • 大小：单个视频不超过 50 MB

  • 帧率（FPS）：[24, 60]

说明

  • 格式：wav、mp3

  • 时长：单个音频时长 [2, 15] s

  • 大小：单个音频不超过 15 MB

ProjectName string

资源所属的项目名称，默认值为default。

若资源不在默认项目中，需填写正确的项目名称，获取项目名称，请查看 文档。

注意：需要和待传入的 Asset Group（素材资产组合）的 ProjectName 保持一致。

响应参数​

Id string

Asset（素材资产）的 Id（Asset ID）。

请求示例​

text
POST /?Action=CreateAsset&Version=2024-01-01 HTTP/1.1
Host: art-api.yuyuflow.com
Content-Type: application/json
X-Date: 20260328T000000Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=AKLTYz******/20260328/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=47a7d934******e41085f

{
  "GroupId": "group-2026**********-*****",
  "URL": "https://example.com/image.jpg",
  "Name": "test",
  "AssetType": "Image",
  "ProjectName": "default"
}

响应示例​

json
{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "Asset-2026**********-*****"
  }
}