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

查询素材资产状态，确认素材是否已完成预处理并可用于推理。

鉴权说明

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

请求参数​

请求体​

Id string 必选

Asset（素材资产）的 Id。

ProjectName string

需要查询的 Asset（素材资产）所属的项目名称，默认值为 default。

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

响应参数​

Id string

Asset（素材资产）的 Id。

Name string

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

URL string

Asset（素材资产）的访问地址。有效期为 12 小时，请及时保存。

AssetType string

Asset（素材资产）的类型。可选值：

  • Image

  • Video

  • Audio

GroupId string

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

Status string

素材资产状态。可选值：

  • Active：已处理完毕，可以使用

  • Processing：正在预处理，无法使用

  • Failed：处理失败

Moderation object

内容审核相关信息。

属性

Moderation.Strategy string

该素材的内容审核策略，该字段返回固定值 Default。

Error object

错误信息。

属性

Error.Code string

错误码。

Code错误原因
FaceMismatch真人脸一致性校验失败，素材中的人脸与参考/授权人脸不一致。
TranscodingFailed媒体转码或处理失败。
ContentRestricted内容安全审核未通过。
DownloadFailed无法下载客户提供的素材 URL。
TypeMismatch上传素材类型与声明类型不一致，例如声明视频但实际是图片。
FormatUnsupported素材格式不支持。
FormatUndetectable无法识别素材格式，可能文件损坏或格式异常。
AudioTrackRequired要求必须包含音轨，但素材中未检测到音轨。
AudioTrackForbidden要求不能包含音轨，但素材中检测到音轨。
DurationTooShort素材时长低于业务要求。
DurationTooLong素材时长超过业务限制。
WidthTooSmall / HeightTooSmall素材宽度或高度低于要求。
WidthTooLarge / HeightTooLarge素材宽度或高度超过限制。
AspectRatioTooSmall / AspectRatioTooLarge素材宽高比不符合要求。
FileSizeTooLarge素材文件大小超过限制。
PixelCountTooSmall / PixelCountTooLarge素材总像素数不符合要求。
FpsTooLow / FpsTooHigh视频帧率不符合要求。
InputTextSensitiveContentDetected文本内容安全审核未通过。
InputImageSensitiveContentDetected图片内容安全审核未通过。
InputVideoSensitiveContentDetected视频内容安全审核未通过。
InputAudioSensitiveContentDetected音频内容安全审核未通过。
InputTextSensitiveContentDetected.PolicyViolation文本涉及版权/政策限制。
InputImageSensitiveContentDetected.PolicyViolation图片涉及版权/政策限制。
InputVideoSensitiveContentDetected.PolicyViolation视频涉及版权/政策限制。
InputAudioSensitiveContentDetected.PolicyViolation音频涉及版权/政策限制。
ModerationServiceErrorUploadFailed审核服务暂不可用或审核上传失败，建议重新上传。
InternalError素材处理过程中出现内部异常。

Error.Message string

错误信息。

CreateTime string

创建时间。

UpdateTime string

更新时间。

ProjectName string

资源所属的项目名称。

请求示例​

text
POST /?Action=GetAsset&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

{
  "Id": "Asset-2026**********-*****",
  "ProjectName": "default"
}

响应示例​

json
{
  "ResponseMetadata": {
    "RequestId": "20260328000000000000000000000000",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "Asset-2026**********-*****",
    "Name": "test",
    "URL": "https://example.com/asset-url",
    "AssetType": "Image",
    "GroupId": "group-2026**********-*****",
    "Status": "Active",
    "Moderation": {            
       "Strategy": "Default"
    },
    "Error": {
      "Code": "",
      "Message": ""
    },
    "CreateTime": "2026-03-28T00:00:00Z",
    "UpdateTime": "2026-03-28T00:00:00Z",
    "ProjectName": "default"
  }
}

错误码​

警告

当 GetAsset API 查询到上传失败资产时，接口可能仍返回 200，您需通过响应中的 Status = Failed 和 Error.Code/Error.Message 获取失败原因。

错误码错误原因
MissingParameter.AssetID未传入资产 ID。
InvalidParameter.AssetID资产 ID 格式不正确。
NotFound.asset_id资产不存在，或当前账号/项目无权访问该资产。
SubscriptionRequired当前套餐不支持读取该类资产能力，例如 AIGC 资产能力不可用。
InternalError服务内部异常，建议稍后重试或联系支持。