Basic Limitation of API¶
Creation of Tile¶
Tile Creation API creates tiles specified by integer seconds(1-900 seconds) when registering a video.
However, tile of level 1 is always created, no matter what your level selection.
Specification of basic tiles are as follows.
| Tile Type | Resolution [px] | |||
|---|---|---|---|---|
| Level 1 | Level 2 | Level 3 | Level 4 | |
| HD | 256 x 144 | 512 x 288 | 768 x 432 | 1024 x 576 |
| SD | 128 x 96 | 256 x 192 | 384 x 288 | 512 x 384 |
| R | 96 x 64 | 192 x 128 | 288 x 192 | 384 x 256 |
| S | 64 x 64 | 128 x 128 | 192 x 192 | 256 x 256 |
If tile’s time duration that you specified is longer than the registered media’s duration, the duration is cut down to the registered media’s duration.
Similarly, if zero or no value has been specified for tile’s duration, tile’s duration is set to the media’s duration.
The media’s duration of less than one second will be rounded up and the time of the fraction will be filled with the last frame of the media.
Note
The left, right, top, and bottom edge part (each 2px) of the combined video for each level tile is filled with black line, thus “Resolution” above specification table includes the black line.
About Tile quality¶
Tile have the concept of Quality. User can set three level quality that is described between 1~3 quality like below.
Multiple quality can be set in media upload phase, also single quality can be set in fv generation and fv request. By doing so, user can select quality according to services or network bandwidth.
Media Data¶
Gnzo holds the created tiles and the meta-data of media only.
| Meta Data | input character qualification |
|---|---|
| media_id | half-width digit |
| caption | half-width alphanumeric、full-width character、symbol (1 - 120 characters) |
| tag | half-width alphanumeric、underline (1 - 120 characters) multiple input is available by inserting comma. |
| description | half-width alphanumeric、full-width character、symbol (1 - 1000 characters) |
| create_date | yyyy-mm-dd hh:mm:ss |
| update_date | yyyy-mm-dd hh:mm:ss |
| status | 0,1 |
Maximum size of fabric video¶
If tile type is same, tile can be combined each other, which creates fabric video (called fv), but the number of tiles to be combined are limited, described as below table.
| tle type | max size | |
|---|---|---|
| column × row [number of tiles] | resolution [px] | |
| HD | 7x7 | 1792x1008 |
| SD | 11x11 | 1408x1056 |
| R | 15x15 | 1440x960 |
| S | 16x16 | 1024x1024 |
About API authentication¶
The API server authenticates client which calls API.
There are two authentication method which are Referrer+Key and Basic authentication.
Please note that the api for (D) marked row line would be deprecated in the future.
| API | Referrer + Key | Basic | |
|---|---|---|---|
| Media registration API | POST /api/1/videos | × | ○ |
| fv cretion request API | GET /api/1/videos/fv | ○ | ○ |
| GET /api/1/videos/fv/timeline | ○ | ○ | |
| GET /api/1/videos/fv/random | ○ | ○ | |
| GET /api/1/videos/fv/search | ○ | ○ | |
| GET /api/1/admin/fv | × | ○ | |
| Media management API | GET /api/1/videos/media | ○ | ○ |
| GET /api/1/videos/{media_id}/info (D) | × | ○ | |
| GET /api/1/videos/info | × | ○ | |
| POST /api/1/videos/{media_id}/info | × | ○ | |
| POST /api/1/videos/{media_id}/activate (D) | × | ○ | |
| POST /api/1/videos/activate | × | ○ | |
| POST /api/1/videos/{media_id}/deactivate (D) | × | ○ | |
| POST /api/1/videos/deactivate | × | ○ | |
| DELETE /api/1/videos/{media_id} (D) | × | ○ | |
| POST /api/1/videos/delete | × | ○ | |
| GET /api/1/videos/{media_id}/tile-status | × | ○ | |
| GET /api/1/videos/tile | × | ○ | |
| GET /api/1/videos/search | × | ○ | |
| GET /api/1/admin/bill_plan | × | ○ | |
| POST /api/1/videos/{media_id}/cancel | × | ○ | |
If ○ symbol is marked on both (Referrer+Key and Basic), first API server will perform Basic authentication. After that, if it fails, API server will perform Referrer + Key(or Key only) authentication.
The basic authentication requires access over HTTPS. If the client try to basic authentication with no HTTPS, the 403 Error will occur.
File Format for Media Registration¶
The file format and Video/Audio Codec for Media Registration are described.
| File Format | Type | Codec |
|---|---|---|
| MPG | Video | MPEG1 |
| MPEG2 | ||
| Audio | MP1 | |
| MP2 | ||
| MP3 | ||
| MOV | Video | MPEG1 |
| MPEG2 | ||
| MPEG4 | ||
| MPEG4 AVC/H.264 | ||
| H.263 | ||
| MOTION JPEG | ||
| Audio | MP3 | |
| AAC | ||
| APPLE LOSSLESS | ||
| AIFF | ||
| MP4 | Video | MPEG1 |
| MPEG2 | ||
| MPEG4 | ||
| MPEG4 AVC/H.264 | ||
| Audio | MP1 | |
| MP2 | ||
| MP3 | ||
| AAC | ||
| AC3 | ||
| APPLE LOSSLESS | ||
| WebM | Video | VP8 |
| Audio | VORBIS | |
| AVI | Video | MPEG1 |
| MPEG2 | ||
| MPEG4 | ||
| MPEG4 AVC/H.264 | ||
| H.263 | ||
| H.261 | ||
| VP8 | ||
| MS-MPEG4 | ||
| VC1 | ||
| THEORA | ||
| MOTION JPEG | ||
| Audio | MP3 LPCM | |
| AAC | ||
| AC3 | ||
| LPCM | ||
| FLAC | ||
| FLV | Video | MPEG4 AVC/H.264 |
| Audio | VP6 | |
| MP3 | ||
| AAC | ||
| PCM | ||
| F4V | Video | MPEG4 AVC/H.264 |
| Audio | MP3 | |
| AAC | ||
| OGG | Video | THEORA |
| Audio | VORBIS | |
| FLAC | ||
| MKV | Video | MPEG1 |
| MPEG2 | ||
| MPEG4 | ||
| MPEG4 AVC/H.264 | ||
| VP8 | ||
| WMV | ||
| VC1 | ||
| THEORA | ||
| MOTION JPEG | ||
| Audio | MP2 | |
| MP3 | ||
| AAC | ||
| AC3 | ||
| WMA | ||
| VORBIS | ||
| FLAC | ||
| ASF | Video | WMV |
| VC1 | ||
| MS-MPEG4 | ||
| Audio | WMA | |
| LPCM | ||
| MP3 |