素材库管理（豆包原生）

方舟素材资产管理接口，网关在同一条路径上提供全部动作。动作由查询参数
Action 选择，JSON 请求体就是官方文档为该动作规定的那一份。

两种鉴权

与其他接口一样接受网关自己的 API Token：Authorization: Bearer sk-xxxx。

也接受火山 AK/SK 签名，因此为官方 SDK 写的脚本只需改 endpoint 即可复用。
管理员在渠道选中的素材库里配置 AK/SK，网关用它为每一次转发签名。

响应

上游信封原样返回：

{ "ResponseMetadata": { ... }, "Result": { ... } }

上游拒绝某个动作时也返回这个信封，需要检查
ResponseMetadata.Error.Code 与 ResponseMetadata.Error.Message。

不计费

素材调用不预扣、不结算额度，每次调用在服务端日志中记录动作名。

一个分组一个渠道

同一分组内最多只能有一个渠道选中素材库。有多个时网关直接拒绝，而不是随机
路由：素材调用没有模型字段可供区分，随机转发会把素材写进别的库。

字段用法

Action	字段
`CreateAsset`	`GroupId`、`URL`、`AssetType`、`Name`、`Description`、`ProjectName`
`GetAsset`	`Id`、`ProjectName`
`ListAssets`	`Filter`、`PageNumber`、`PageSize`、`SortBy`、`SortOrder`、`ProjectName`
`UpdateAsset`	`Id`、`Name`、`ProjectName`
`DeleteAsset`	`Id`、`ProjectName`
`CreateAssetGroup`	`Name`、`Description`、`GroupType`、`ProjectName`
`GetAssetGroup`	`Id`、`ProjectName`
`ListAssetGroups`	`Filter`、`NextToken`、`MaxResults`、`PageNumber`、`PageSize`、`SortBy`、`SortOrder`、`ProjectName`
`UpdateAssetGroup`	`Id`、`Name`、`Description`、`ProjectName`
`DeleteAssetGroup`	`Id`、`ProjectName`

CreateAsset 是异步接口：轮询 GetAsset 直到 Status 变为 Active，
才能在生成请求里引用该素材 id。只有 Active 状态的素材可用。

application/json

上游信封，原样返回。

Bodyapplication/json

{
    "ResponseMetadata": {
        "RequestId": "20260328000000000000000000000000",
        "Action": "CreateAsset",
        "Version": "2024-01-01",
        "Service": "ark",
        "Region": "cn-beijing"
    },
    "Result": {
        "Id": "Asset-2026**********-*****"
    }
}

素材库管理（豆包原生）

请求参数

请求示例代码

返回响应