---
title: "Download Library"
method: POST
path: "/api/v1/byteplus-assets/download"
tags: ["bytplusArc"]
---

# Download Library

`POST /api/v1/byteplus-assets/download`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/byteplus-assets/download`
- Auth: HTTP bearer

Zip the asset library (or one group): a folder per group plus manifest.csv.

Returns a `task_id`. Pulling every file outlives the request deadline, so
poll `GET /byteplus-assets/download/{task_id}`; `Done` carries a signed
`download_url` valid for 15 minutes (poll again for a fresh one).

## Request body

- LibraryDownloadRequest
  - `group_type` string: AIGC or LivenessFace
  - `group_id` string, nullable: Only this group; omit for every group of group_type

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-21** `487039c34e7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/byteplus-assets/download/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)
