查询素材

国际站

https://api.omove.ai

POST

/openapi/volcengine/

查询素材详情和处理状态。请求体仅包含 Id，不包含 ProjectName；Action 和 Version 是固定查询参数。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200查询成功

application/json

返回素材信息和处理状态。Processing 时建议继续轮询；Active、Ready 或 READY 表示可用；Failed 表示处理失败。

Bodyapplication/json

🟠400请求或资源错误

🟠404素材不存在

🟠409素材 ID 冲突

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.omove.ai/openapi/volcengine/?Action=GetAsset&Version=2024-01-01' \
--header 'X-Date: 20260727T070005Z' \
--header 'X-Content-Sha256: be20397df967b5cac3a0532466d8af339895325f81853ce0c34e70fffbfe95a4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "Id": "asset-20260727150001-a1b2c3"
}'

响应示例

200 - 处理成功

{
  "ResponseMetadata": {
    "RequestId": "20260727150016ABCDEF1234567890",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727150001-a1b2c3",
    "Name": "城市夜景参考图",
    "GroupId": "group-20260727143000-aigc001",
    "AssetType": "Image",
    "Status": "Active",
    "URL": "https://ark-media.example.com/assets/a1b2c3",
    "CreateTime": "2026-07-27T15:00:01+08:00",
    "UpdateTime": "2026-07-27T15:00:16+08:00"
  }
}

修改于 2026-08-07 09:10:20

上传素材