---
title: "GET /api/video_eval/"
method: GET
path: "/api/video_eval/"
tags: ["video_eval"]
---

# GET /api/video_eval/

`GET /api/video_eval/`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-ID` and API key in header `X-API-KEY`

Judge a generated video for product fidelity, realism, quality, prompt
adherence and audio.

Async only — POST returns immediately with a job id; poll the detail route
or supply ``webhook_url``.

## Response `200`

- VideoEvalResponse[]
  - `id` string, uuid, required
  - `status` 'pending' | 'running' | 'failed' | 'done', required: * `pending` - Pending * `running` - Running * `failed` - Failed * `done` - Done
  - `judge` 'dimensions' | 'tunable', required: * `dimensions` - Dimensions * `tunable` - Tunable
  - `tolerance` number, double, nullable, required: How much imperfection the tunable judge forgives, 0-10. Null for the dimensions judge, which has no adjustable bar.
  - `video_url` string, uri, required: URL of the video to evaluate.
  - `passed` boolean, nullable, required: True only when every evaluated dimension returned PASS.
  - `dimensions` object, required: Per-dimension verdicts, keyed by dimension name: product_fidelity, physical_realism, visual_quality, prompt_adherence, audio_quality. Keys are input-dependent — do not assume all five are present. Always empty for judge='tunable', which does not decompose its verdict — see `reasoning` instead.
  - `reasoning` string, required: Why the verdict came out the way it did, for judges that argue to one answer instead of scoring dimensions. Empty for judge='dimensions', whose reasoning is per-dimension above.
  - `duration_seconds` number, required: Wall-clock seconds the eval took.
  - `credits_used` number, required: Credits charged for this call. Refunded to 0 when the eval fails.
  - `failed_reason` string, required: Reason for failure if status is failed.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Changes

- **2026-11-03** `8423ba73b422`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/creatify/apis/creatify-ai-api/changes/api/video_eval/get.md)

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) - [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creatify/apis/creatify-ai-api/revisions/8423ba73b422?raw)