GetAsset 查询素材状态(轮询)

POST

/v1/volc/ark/

轮询 asset_status:Processing → Active/Failed,仅 Active 可用于视频生成。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

Body 参数application/json必填

示例

{
    "Id": "hb-yyyyyyyy"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/volc/ark/?Action=GetAsset&Version=2024-01-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Id": "hb-yyyyyyyy"
}'

返回响应

🟢200

application/json

成功。返回素材状态;Id/GroupId 均为平台脱敏后的 hb-/hbg-。URL 为火山 12h 预览地址(平台不持久化)

Bodyapplication/json

示例

{
    "ResponseMetadata": {
        "Action": "GetAsset",
        "RequestId": "2026...",
        "Region": "cn-beijing",
        "Service": "ark",
        "Version": "2024-01-01"
    },
    "Result": {
        "AssetType": "Image",
        "CreateTime": "2026-06-22T08:06:23Z",
        "GroupId": "hbg-3V1lztXLe9Wzj399OyLm",
        "Id": "hb-MnP48NWmWCa3S3zYJNZ9",
        "Moderation": {
            "Strategy": "Default"
        },
        "Name": "人脸照-2",
        "ProjectName": "hbkj",
        "Status": "Active",
        "URL": "https://ark",
        "UpdateTime": "2026-06-22T08:06:26Z"
    }
}

修改于 2026-06-23 11:14:56

CreateAsset 入库素材(传 URL,异步)

ListAssets 列出素材(Filter 过滤)