You need to enable JavaScript to run this app.
文档中心
火山方舟

火山方舟

复制全文
下载 pdf
管理私域素材库
查询素材资产信息
复制全文
下载 pdf
查询素材资产信息
POST https://ark.cn-beijing.volcengineapi.com/?Action=GetAsset&Version=2024-01-01​
查询素材资产状态,确认素材是否已完成预处理并可用于推理。​
注意​
当 GetAsset API 查询到上传失败资产时,接口可能仍返回 200,您需通过响应中的 Status = Failed 和 Error.Code / Error.Message 获取失败原因。​
鉴权​
本接口支持鉴权方式如下,详情请参见 Base URL 及鉴权。​
  • Access Key 鉴权,请在 Access Key 管理 页面,获取 Access Key。本接口仅支持 Access Key 鉴权。​
​​
请求参数​
Body 参数​
Id string 必选 | 素材 ID​
​
ProjectName string 默认值 default | 所属项目​
​
​
响应参数​
AssetType string | 素材类型​
​
CreateTime string | 创建时间​
​
Error object | 错误信息​
​
GroupId string | 所属素材组 ID​
​
Id string | 素材 ID​
​
LastInferenceTime string | 最近推理时间​
​
Moderation object | 内容审核​
​
Name string | 素材名称​
​
ProjectName string | 所属项目​
​
Status string | 素材状态​
​
UpdateTime string | 更新时间​
​
URL string | 访问地址​
​
​

Request

curl 'https://ark.cn-beijing.volcengineapi.com/?Action=GetAsset&Version=2024-01-01' \
  -H 'Content-Type: application/json' \
  -H 'X-Date: <X-Date>' \
  -H 'X-Content-Sha256: <X-Content-Sha256>' \
  -H 'Authorization: HMAC-SHA256 Credential=<AK>/<X-Date>/cn-beijing/ark/request, SignedHeaders=content-type;host;x-content-sha256;x-date, Signature=<Signature>' \
  -d '{
    "Id": "asset-20240514212750-a3f8k",
    "ProjectName": "default"
}
'

Response

{
    "ResponseMetadata": {
        "RequestId": "20240514213000E5F6789ABCDEF01234",
        "Action": "GetAsset",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "asset-20240514212750-a3f8k",
        "Name": "demo-portrait-image",
        "URL": "https://ark-asset.cn-beijing.volcengine.com/asset-20240514212750-a3f8k.jpg?X-Amz-Expires=43200",
        "AssetType": "Image",
        "GroupId": "group-20240514212750-b5e9m",
        "Status": "Active",
        "Moderation": {
            "Strategy": "Default"
        },
        "Error": {
            "Code": "",
            "Message": ""
        },
        "CreateTime": "2024-05-14T21:27:50Z",
        "UpdateTime": "2024-05-14T21:30:00Z",
        "LastInferenceTime": "2024-05-14T22:15:30Z",
        "ProjectName": "default"
    }
}
最近更新时间:2026.09.04 20:18:00
这个页面对您有帮助吗?
有用
有用
无用
无用