Manage the asset library (Doubao native)

Ark asset-library management, served by the gateway on one path. The
operation is selected by the Action query parameter, and the JSON body
is the one the official Ark API documents for that action.

Two authentication forms

The gateway accepts the same API token as every other endpoint here:
Authorization: Bearer sk-xxxx.

Volcengine AK/SK signatures are accepted as well, so a script written
for the official SDK works after only the endpoint changes. An
administrator configures the AK/SK on the asset library the channel
selects; the gateway signs every forwarded call with it.

Responses

The upstream envelope is returned unchanged:

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

An action that fails at the upstream still answers with this envelope;
check ResponseMetadata.Error.Code and ResponseMetadata.Error.Message.

No billing

Asset calls reserve and settle no quota. Each call is recorded in the
server log with its action.

One channel per group

A group may contain at most one channel with an asset library selected.
Two of them are rejected rather than routed at random, because an asset
call carries no model field to tell them apart.

Field usage

Action	Fields
`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 is asynchronous: poll GetAsset until Status is Active
before referencing the asset id in a generation request. Only Active
assets may be used.

application/json

The upstream envelope, returned unchanged.

Bodyapplication/json

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

Manage the asset library (Doubao native)

请求参数

请求示例代码

返回响应