> ## Documentation Index
> Fetch the complete documentation index at: https://developers.eyequant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a video analysis

> Submit a video for per-frame visual saliency analysis.

Create a visual saliency analysis for a video. The request returns `201 Created` with the new `id` and a `location` URL (also returned in the `Location` response header). Poll [Get a video analysis](/api-reference/get-video-analysis) with the returned `id` to retrieve the result.

<Warning>
  Video analysis is gated by the `dynamic-saliency` add-on. If it is not enabled for your account, this endpoint returns `404`. Contact [sales@eyequant.com](mailto:sales@eyequant.com) to enable it.
</Warning>

<Note>
  The video `content` must be an AWS S3 URL presigned by EyeQuant. See [Analyze videos](/guides/analyzing-videos) for how to obtain one and the supported video requirements.
</Note>

<ParamField body="input" type="object" required>
  The video input specification.

  <Expandable title="input properties">
    <ParamField body="content" type="string" required>
      The URL to the video. Currently only AWS S3 URLs presigned by EyeQuant are allowed.
    </ParamField>

    <ParamField body="title" type="string" required>
      The title of the video.
    </ParamField>
  </Expandable>
</ParamField>

<ResponseField name="id" type="string">
  The id of the new video analysis.
</ResponseField>

<ResponseField name="location" type="string">
  The URL where the result can be retrieved (also returned in the `Location` header).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl \
    -X POST \
    -H "Authorization: Bearer $apikey" \
    -H "Content-Type: application/json" \
    -d '{"input":{ "content":"https://s3.example.com/video-test-eyequant/users/EQWML/7ee3f6ce-a259-46e9-8eae-7964b56ca004-vi-0", "title":"The video title." }}' \
    https://api.eyequant.com/v2/analyses/video
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "eddec58c-b843-4c8e-a6dd-19155094a1a7",
    "location": "https://api.eyequant.com/v2/analyses/video/eddec58c-b843-4c8e-a6dd-19155094a1a7"
  }
  ```

  ```json 400 theme={null}
  {
    "error": {
      "code": "invalid_request",
      "message": "Invalid request."
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "resource_not_found",
      "message": "We could not find an analysis for the given id."
    }
  }
  ```
</ResponseExample>