# Image API Docs

## General Information

\
A picture is worth a thousand words! Take advantage of Origin Nexus’s huge library of images and screen captures to create a stunning entertainment discovery experience.

Images are to be downloaded from Origin Nexus as per our Terms of Service. It is up to the client to manage, host, and serve the images they wish to use.

Be sure to check image availability as images may be removed from the system at which point they should also be removed from the client system.

The [Image API](/origin/apis-all/image-api-docs/images.md) allows you to retrieve an image or a batch of images based on the FilePath. The FilePaths can be found inside the Entertainment API or the Celebrity API.

* [**/Images/{FilePath}/Redirect**](/origin/apis-all/image-api-docs/images.md#get-filepath-redirect) - Allows you to get a single image.
* [**/Images/ScreenCaptures/Redirect**](/origin/apis-all/image-api-docs/images.md#get-screencaptures-redirect) - Allows you to get one screen capture for a video asset.
* [**/Images/Batch**](/origin/apis-all/image-api-docs/images.md#post-batch) - Allows you to get a batch of images by passing an array of FilePaths.
* [**/Images/ScreenCaptures/Batch**](/origin/apis-all/image-api-docs/images.md#post-screencaptures-batch) - Allows you to get a batch of video asset screen captures in one API call by passing an array of FilePaths.

The examples below illustrate the types of images contained in the database.

*Related API Guides:* [*Entertainment API*](/origin/apis-all/entertainment-api-docs.md)*.*

*Open API/Swagger documentation can be found on the Image API page.*

### “Promotional Use” Terms and Conditions for Poster, Photo, and Portrait Images

\
Posters, Photos and Portraits in our database are related to a specific movie, TV or game title and are promotional images for that title. If you have title pages or articles about that title, then offering an image gallery on that page is obviously promotional. If you are doing editorial about another topic and use an image from Origin Nexus, you need to reference or otherwise indicate the title of the film, TV show, or game to be promotional.

### Terms and Conditions for Headshots

\
Only Origin Nexus customers can use headshots. Headshots can be used in cast lists for any program where celebrity is a contributor. If headshot is used for editorial articles about the celebrity, article cannot be obscene, defamatory, libelous, or slanderous. If headshot is used for editorial articles, it must include attribution of “Courtesy of \[attribution name].”

[headshot access form](https://www.fabricdata.com/developer/headshots-access-form)

### Image Types

* **Poster** - Poster for the program in 2x3 aspect ratio.
* **Theatrical Poster** - Poster has been identified as having legal lines.
* **Box Art** - Image has been identified as promoting physical product.
* **Tile** - Poster for the program in 16x9 or 4x3 aspect ratio.
* **Photo** - Production Stills, Backdrops, Backgrounds, etc.
* **Screen Capture** - Hero shot taken from video for use in video player as placeholder image.
* **Portrait** - Created from a photo, celebrity’s face has been detected and a 200x300 image was created. Image can only be used in conjunction with promoting that program.
* **Headshot** - Image of celebrity used to promote the celebrity themselves. Headshots will have attribution. If attribution is Everett Collection, then image is a licensed, red-carpet headshot with only that celebrity. If image attribution is Origin Nexus, then headshot was provided directly to Origin Nexus.

*NOTE: Image Types can be collected from our API by making use of the GetImageTypes endpoint.*

### Posters

* Origin Nexus images feature a violence and a sexuality score to allow developers to filter out more graphic images if they choose.
* Origin Nexus recommends using posters marked as “official” in the metadata.
* Poster sizes are typically 2x3 aspect ratios.
* Posters have language designations to make it easy to localize.

<figure><img src="/files/ICPyYyOEPUAeMjSgkrFl" alt="" width="375"><figcaption><p>Example (FilePath - "f0cb9a7575771821a1d49387129e02d8")</p></figcaption></figure>

### Theatrical Posters

* A poster with a 2x3 aspect ratio but has legal lines (multiple credits with director, cast, editors, producers, distributor, etc.). These were mainly used for in theatre promotions.
* Mostly found with older titles.

<figure><img src="/files/4KC0llXKZy02IG11h6ux" alt="" width="375"><figcaption></figcaption></figure>

### Box Art

* Will typically have the words Blu-Ray, 4K UltraHD, DVD, VHS, etc.
* Used for promoting physical product.

<figure><img src="/files/uAOrJQSru3xj7tAbnGKn" alt="" width="375"><figcaption></figcaption></figure>

### Tiles

* Tiles will be 16x9 or 4x3 aspect ratio.
* Tiles are an alternative to 2x3 poster art.

<figure><img src="/files/Ck36VLjPMg7TwKimLFPA" alt="" width="563"><figcaption></figcaption></figure>

### Photos

* Origin Nexus images feature a violence and a sexuality score to allow developers to filter out more graphic images if they choose.
* Origin Nexus recommends using photos marked as “official” in the metadata.
* Photo sizes and aspect ratios may vary.

<figure><img src="/files/9jZIZwRUsNSgwrHwJGcj" alt="" width="563"><figcaption><p>Example (FilePath - "6ba4a3880cd1704635cdf4af1f8be45b")</p></figcaption></figure>

### Screen Captures

* Origin Nexus team hand selects a "hero" shot from promotional videos.
* Image can be used inside a video player to prominently display as part of the interface.
* One still per video asset (16x9 & 4x3 versions available).
* Size of the image depends on the video source.

<div align="center"><figure><img src="/files/Hy4pO2MQeKRdw1yyOcrT" alt="" width="375"><figcaption><p>16x9</p></figcaption></figure> <figure><img src="/files/OUkSur3zZtFClwqTCt1K" alt="" width="188"><figcaption><p>4x3</p></figcaption></figure></div>

### Portraits

* Portraits of the person also include additional metadata including face details and facial landmarks.
* Origin Nexus images feature a violence and a sexuality score to allow developers to filter out more graphic images if they choose.

<div align="center"><figure><img src="/files/CGTVnMkgyc5shKi6xNyW" alt=""><figcaption></figcaption></figure> <figure><img src="/files/R2f8xGIyOpxz6Dx7YYuj" alt=""><figcaption></figcaption></figure> <figure><img src="/files/VVwWExVEW4qrZ1g2yqzR" alt=""><figcaption></figcaption></figure></div>

### Headshots

* Image of celebrity used to promote the celebrity themselves. Headshots will have attribution. If attribution is *Everett Collection*, then image is a licensed, red-carpet headshot with only that celebrity. If image attribution is *Origin Nexus*, then headshot was provided directly to Origin Nexus.

<div align="center" data-full-width="false"><figure><img src="/files/atInBOp0TQZkeSg5qO3x" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/zyDrtu3O0cZEuozH16N6" alt="" width="188"><figcaption></figcaption></figure> <figure><img src="/files/Pkge4HWUlfUA2s5pCydI" alt="" width="188"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.fabricdata.com/origin/apis-all/image-api-docs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.