@@ -31,28 +31,28 @@ class ConvertedVideo(BaseModel):
3131 For each converted video, additional download endpoints are available under
3232 `converted_videos`/`mp4_urls`. An MP4 download enpoints:
3333
34- - /videos/{` client_id`} \\ __ {slug}/{filename}.mp4
35- - /videos/{` client_id`} \\ __ {slug}/{filename}.mp4/download
36- - /videos/{` client_id`} \\ __ {slug}/{filename}.mp4/download={` custom_filename`}
34+ 1. ` /videos/{client_id}_ {slug}/{filename}.mp4`
35+ 2. ` /videos/{client_id}_ {slug}/{filename}.mp4/download`
36+ 3. ` /videos/{client_id}_ {slug}/{filename}.mp4/download={custom_filename}`
3737
3838 The first option returns the file as is. Response will be:
3939
4040 ```
41- GET .mp4
42- ...
43- content-type: video/mp4
41+ GET .mp4
42+ ...
43+ content-type: video/mp4
4444 ```
4545
46- The second option with /download will respond with HTTP response header that
46+ The second option with ` /download` will respond with HTTP response header that
4747 directly tells browsers to download the file instead of playing it in the
4848 browser:
4949
5050 ```
51- GET .mp4/download
52- ...
53- content-type: video/mp4
54- content-disposition: attachment
55- access-control-expose-headers: Content-Disposition
51+ GET .mp4/download
52+ ...
53+ content-type: video/mp4
54+ content-disposition: attachment
55+ access-control-expose-headers: Content-Disposition
5656 ```
5757
5858 The third option allows you to set a custom name for the file being downloaded.
@@ -68,18 +68,18 @@ class ConvertedVideo(BaseModel):
6868 - Example valid filenames: `holiday2025`, `_backup.final`, `clip-v1.2`
6969
7070 ```
71- GET .mp4/download={custom_filename}
72- ...
73- content-type: video/mp4
74- content-disposition: attachment; filename="{custom_filename}.mp4"
75- access-control-expose-headers: Content-Disposition
71+ GET .mp4/download={custom_filename}
72+ ...
73+ content-type: video/mp4
74+ content-disposition: attachment; filename="{custom_filename}.mp4"
75+ access-control-expose-headers: Content-Disposition
7676 ```
7777
7878 Examples:
7979
80- - Video :
80+ - MP4 :
8181 `https://demo-public.gvideo.io/videos/2675_1OFgHZ1FWZNNvx1A/qid3567v1_h264_4050_1080.mp4/download`
82- - Video with custom download filename:
82+ - MP4 with custom download filename:
8383 `https://demo-public.gvideo.io/videos/2675_1OFgHZ1FWZNNvx1A/qid3567v1_h264_4050_1080.mp4/download=highlights_v1.1_2025-05-30`
8484
8585 **Default MP4 file name structure**
@@ -107,11 +107,10 @@ class ConvertedVideo(BaseModel):
107107
108108 Read more in Product Documentation in CDN section "Network limits".
109109
110- **Secure token authentication (updated)**
110+ **Secure token authentication for MP4 (updated)**
111111
112- Access to MP4 download links can be protected using secure tokens passed as
113- query parameters. The token generation logic has been updated to allow
114- fine-grained protection per file and bitrate.
112+ Access to MP4 download links only can be protected using advanced secure tokens
113+ passed as query parameters.
115114
116115 Token generation uses the entire MP4 path, which ensures the token only grants
117116 access to a specific quality/version of the video. This prevents unintended
@@ -207,7 +206,10 @@ class Video(BaseModel):
207206
208207 This URL is a link to the main manifest. But you can also manually specify
209208 suffix-options that will allow you to change the manifest to your request:
210- `/videos/{client_id}_{slug}/master[-min-N][-max-N][-(h264|hevc|av1)].mpd`
209+
210+ ```
211+ /videos/{client_id}_{slug}/master[-min-N][-max-N][-(h264|hevc|av1)].mpd
212+ ```
211213
212214 List of suffix-options:
213215
@@ -259,9 +261,9 @@ class Video(BaseModel):
259261 """
260262
261263 hls_url : Optional [str ] = None
262- """A URL to a master playlist HLS (master.m3u8).
263-
264- Chunk type will be selected automatically:
264+ """
265+ A URL to a master playlist HLS (master.m3u8). Chunk type will be selected
266+ automatically:
265267
266268 - TS if your video was encoded to H264 only.
267269 - CMAF if your video was encoded additionally to H265 and/or AV1 codecs (as
@@ -270,7 +272,10 @@ class Video(BaseModel):
270272
271273 You can also manually specify suffix-options that will allow you to change the
272274 manifest to your request:
273- `/videos/{client_id}_{video_slug}/master[-cmaf][-min-N][-max-N][-img][-(h264|hevc|av1)].m3u8`
275+
276+ ```
277+ /videos/{client_id}_{video_slug}/master[-cmaf][-min-N][-max-N][-img][-(h264|hevc|av1)].m3u8
278+ ```
274279
275280 List of suffix-options:
276281
@@ -287,15 +292,16 @@ class Video(BaseModel):
287292
288293 ABR soft-limiting: Soft limitation of the list of qualities allows you to return
289294 not the entire list of transcoded qualities for a video, but only those you
290- need. For more details look at the Product Documentation. For example, the video
291- is available in 7 qualities from 360p to 4K, but you want to return not more
292- than 480p only due to the conditions of distribution of content to a specific
293- end-user (i.e. free account) :
295+ need. For example, the video is available in 7 qualities from 360p to 4K, but
296+ you want to return not more than 480p only due to the conditions of distribution
297+ of content to a specific end-user (i.e. free account): ABR soft-limiting
298+ examples :
294299
295300 - To a generic `.../master.m3u8` manifest
296301 - Add a suffix-option to limit quality `.../master-max-480.m3u8`
297302 - Add a suffix-option to limit quality and codec
298- `.../master-min-320-max-320-h264.m3u8`
303+ `.../master-min-320-max-320-h264.m3u8` For more details look at the Product
304+ Documentation.
299305
300306 Caution. Solely master.m3u8 (and master[-options].m3u8) is officially documented
301307 and intended for your use. Any additional internal manifests, sub-manifests,
@@ -353,12 +359,9 @@ class Video(BaseModel):
353359 - If the video is a recording of a live stream
354360 - Otherwise it is "null"
355361
356- **Copy from another server**
357-
358- URL to an original file that was downloaded. Look at method "Copy from another
359- server" in POST /videos.
360-
361- **Recording of an original live stream**
362+ **Copy from another server** URL to an original file that was downloaded. Look
363+ at method "Copy from another server" in POST /videos. **Recording of an original
364+ live stream**
362365
363366 URL to the original non-transcoded stream recording with original quality, saved
364367 in MP4 format. File is created immediately after the completion of the stream
![stainless-app[bot]](https://avatars.githubusercontent.com/in/378072?v=4&size=40){kind=avatar}
0 commit comments