Release notes
|
|
|
|
AP Media API version 2.2 build 2.2.22
Vertical video rendition DUIDs
You can access vertical video renditions, if available, using the following DUIDs returned in the Media API responses:
|
DUID |
Specifications |
Media Agent dashboard option |
|---|---|---|
|
vid-1920p-main-50 |
Vertical Main HD @50Hz, progressive, 1080x1920 |
Vertical HD (CR): 1080x1920p50 MP4 |
|
vid-1920p-main-60 |
Vertical Main HD @60Hz, progressive, 1080x1920 |
Vertical HD (CR): 1080x1920p60 MP4 |
|
vid-1920p-physicalmain-50-10 |
Vertical Archive Main HD @50Hz, progressive |
Archive: Highest Quality Available delivers the one Main available for download without transcoding |
|
vid-1920p-physicalmain-60-10 |
Vertical Archive Main HD @60Hz, progressive |
|
|
img-1080x1920 |
Vertical thumbnail |
JPG: Thumbnail (under Video) |
For more information, see Rendition DUIDs.
Timecoded transcript renditions
In addition to the traditional NITF-formatted script renditions for video, Media API now returns timecoded video transcript renditions in the JSON and NITF formats when available. A timecoded transcript provides the text of all the dialog in the video tagged with the time references. Make sure to review the editor's note in the transcript file for important information about the AI-generated transcriptions.
Timecoded rendition DUIDs
You can access timecoded transcript renditions, if available, using the following DUIDs returned in the Media API responses:
|
DUID |
Description |
Media Agent dashboard option |
|---|---|---|
|
txt-json-transcript |
Timecoded video transcript in the JSON format |
JSON: Timecoded transcript |
|
txt-nitf-transcript |
Timecoded video transcript in the NITF format |
NITF: Timecoded transcript |
Example: Timecoded transcript renditions in the response
...
For more information, see Timecoded transcript renditions.
API version timeline
|
The Media API version 2.2 build 2.2.22 is the default API version. |
|
|
|
|
|
Requesting... |
Returns... |
When... |
|
/v (the default API version) |
API version 2.2 |
Now |
|
/v2.2 (API version 2.2) |
API version 2.2 |
Now until API version 2.2 is retired |
Example: https://api.ap.org/media/v/content/feed
AP Media Agent 11.0.4 and dashboard 3.0.7
|
|
|
|
The latest agent version 11.0.4, which is available for download, includes performance improvements for better stability and support for timecoded transcript renditions. If you are running older versions of the agent, we strongly urge you to automatically upgrade to the latest version to avoid potential issues and take full advantage of the new features and improved performance in the latest releases of the agent, dashboard and AP Media API. |
|
|
|
|
ImportantVertical video rendition download options
Two new options for downloading vertical video renditions are now available on the Content Options tab of the Content Profile page on the Media Agent dashboard:
|
Media Agent dashboard option |
Specifications |
DUID |
|---|---|---|
|
Vertical HD (CR): 1080x1920p50 MP4 |
Vertical Main HD @50Hz, progressive, 1080x1920 |
vid-1920p-main-50 |
|
Vertical HD (CR): 1080x1920p60 MP4 |
Vertical Main HD @60Hz, progressive, 1080x1920 |
vid-1920p-main-60 |
For more information, see Rendition DUIDs.
Timecoded rendition download options
|
|
|
|
Agent version 11.0.4 is required for timecoded rendition downloads. |
|
|
|
|
New download options for saving timecoded renditions are now available on the Content Options tab of the Content Profile page on the Media Agent dashboard:
-
NITF: Timecoded transcript. Saves timecoded video transcripts in the NITF format.
-
JSON: Embed Timecoded NITF Text. In conjunction with JSON: Item Files, embeds timecoded NITF transcripts in the JSON item files.
-
XML: Embed Timecoded NITF Text. In conjunction with XML: Item Files (NewsML-G2), embeds timecoded NITF transcripts in the NewsML-G2 item files.
-
JSON: Timecoded transcript. Saves timecoded video transcripts in the JSON format.
For more information, see Timecoded transcript renditions.