Returns the configuration of a specific library. This page focuses only on the hls_segment_duration field.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /library/{library_id}
{library_id}Returns the configuration of a specific library. This page documents only the hls_segment_duration field.
The HLS segment duration is how long each .ts piece of a transcoded video lasts. It is configurable per library (default 6 seconds). A larger segment produces fewer files, and therefore fewer requests to the CDN and to storage — a cost lever. It does not reduce bandwidth in GB (the bitrate is the same), and it can slightly increase time-to-first-frame and reduce seek precision.
AuthorizationRequires a valid API token in the
Authorizationheader (noBearerprefix).
HTTP Method & Path
GET /library/{library_id}
Base URL: https://api-v2.pandavideo.com.br
PathIt is
/library/{library_id}(singular), and thelibrary_idgoes in the URL — not in the body.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
library_id | string (uuid) | yes | Unique identifier of the library. |
The HLS field in the response
| Field | Type | Description |
|---|---|---|
hls_segment_duration | integer | Duration of each HLS segment in seconds (4–15, default 6). |
The returned value is the one that applies to new uploads and reencodes.
Success Response (200)
{
"data": {
"hls_segment_duration": 6
}
}Error Responses
- 404 — library not found.
Example — cURL
curl -X GET "https://api-v2.pandavideo.com.br/library/{library_id}" \
-H "Authorization: {api_key}"