查询素材详情

Authorization

AuthorizationBearer <token>

兼容网关 API Key，例如 sk-...。

In: header

Query Parameters

Action*string

Default"GetAsset"

Version*string

Default"2024-01-01"

Header Parameters

X-Date?string

使用 HMAC-SHA256 时必填，格式为 YYYYMMDDTHHMMSSZ。

X-Content-Sha256?string

使用 HMAC-SHA256 时必填，请求体 SHA-256 小写十六进制。

Request Body

application/json

Id*string

素材 ID。

ProjectName?string

资源所属项目名称，大小写敏感。省略时使用 default。

Default"default"

Response Body

application/json

curl -X POST "https://jieyun.cc/?Action=GetAsset&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "Id": "asset-202607210001-example",
    "ProjectName": "default"
  }'

curl -X POST "https://jieyun.cc/?Action=GetAsset&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "Id": "asset-202607210001-example",    "ProjectName": "default"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260721000000000000000000000000",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-202607210001-example",
    "Name": "产品主图",
    "URL": "https://example.com/temporary/product.png",
    "GroupId": "group-202607210001-example",
    "AssetType": "Image",
    "Status": "Active",
    "Moderation": {
      "Strategy": "Default"
    },
    "Error": {
      "Code": "",
      "Message": ""
    },
    "ProjectName": "default",
    "CreateTime": "2026-07-21T00:00:00Z",
    "UpdateTime": "2026-07-21T00:00:00Z"
  }
}

{
  "ResponseMetadata": {
    "RequestId": "string",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "string",
      "Message": "string"
    }
  }
}

Empty

接口说明

查询单个素材的信息和异步预处理状态。本文档已按火山引擎官方接口说明校对。

POST https://jieyun.cc/?Action=GetAsset&Version=2024-01-01
Content-Type: application/json
Authorization: Bearer <API_KEY>

也可使用 AK/SK HMAC-SHA256 签名，详见素材库认证与签名。

HTTP 200 不代表素材处理成功

接口返回 HTTP 200 时，素材状态仍可能是 Failed。业务代码必须检查 Result.Status；失败原因位于 Result.Error.Code 和 Result.Error.Message。

请求参数

字段	类型	必选	说明
`Id`	string	是	素材 ID。
`ProjectName`	string	否	素材所属项目，默认 `default`，大小写敏感。

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

响应内容

字段	类型	说明
`Id`	string	素材 ID。
`Name`	string	素材名称。
`URL`	string	素材临时访问地址，有效期为 12 小时。
`AssetType`	string	`Image`、`Video` 或 `Audio`。
`GroupId`	string	所属素材组 ID。
`Status`	string	`Active`、`Processing` 或 `Failed`。
`Moderation.Strategy`	string	内容审核策略，当前固定为 `Default`。
`Error.Code`	string	处理失败错误码。
`Error.Message`	string	处理失败错误信息。
`CreateTime`	string	创建时间。
`UpdateTime`	string	更新时间。
`ProjectName`	string	所属项目名称。

创建素材后，应持续轮询本接口：Processing 表示暂不可用，Active 表示可以用于推理，Failed 表示处理失败。

200application/json

400application/json

401

403

404

503

application/json

application/json