---
title: "Preview Input Framing"
method: POST
path: "/api/jobs/preview/input-framing"
---

# Preview Input Framing

`POST /api/jobs/preview/input-framing`

## Request

- Base URL: `https://api.animgen.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.animgen.com/api/jobs/preview/input-framing`
- Auth: none declared

Read-only, authenticated geometry preflight; never queues or bills a job.

## Request body

- ImageToVideoJobCreate
  - `type` 'image_to_video', required
  - `workspaceId` string, uuid, nullable
  - `prompt` string
  - `negativePrompt` string
  - `params` ImageToVideoParams, required
    - `targetDurationSeconds` number, required
    - `provider` string, nullable
    - `model` string, nullable
    - `generationMode` 'first_frame' | 'first_last_frame' | 'reference_images', nullable
    - `seed` integer, nullable
    - `stylePreset` string, nullable
    - `resolution` string, nullable
    - `ratio` string, nullable
    - `watermark` boolean, nullable
    - `transparency` ImageTransparencyConfig
      - `mode` 'alpha_key' | 'matting'
      - `keyColor` string, nullable
      - `keySelection` 'auto' | 'manual'
      - `profile` 'generated_video_v1' | 'generated_video_v2'
    - `inputCanvas` ImageInputCanvasConfig
      - `version` 1
      - `enabled` boolean
      - `sourceScale` number
      - `positionX` number
      - `positionY` number
      - `aspectRatio` 'follow_output' | 'source'
      - `background` 'auto' | 'transparent' | 'solid'
      - `backgroundColor` string, nullable
    - `purchaseIntentId` string, uuid, nullable
  - `initImageUploadId` string, uuid, nullable
  - `initImageSource` MediaSourceInput
    - `type` 'upload' | 'asset', required
    - `id` string, uuid, required
  - `lastFrameUploadId` string, uuid, nullable
  - `lastFrameSource` MediaSourceInput
    - `type` 'upload' | 'asset', required
    - `id` string, uuid, required
  - `referenceImages` ReferenceImageInput[]
    - `uploadId` string, uuid, nullable
    - `source` MediaSourceInput
      - `type` 'upload' | 'asset', required
      - `id` string, uuid, required
    - `role` 'character' | 'prop' | 'style' | 'other'
    - `label` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `0504d838139a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/animgen/apis/aianimgenbackend/changes/api/jobs/preview/input-framing/post.md)

---

[API](https://skmtc.dev/animgen/apis/aianimgenbackend.md) · [All operations](https://skmtc.dev/animgen/apis/aianimgenbackend/llms.txt) · [OpenAPI document](https://skmtc.dev/animgen/apis/aianimgenbackend/revisions/0504d838139a?raw)