---
title: "Quote Video Generation"
method: POST
path: "/v1/video-generations/quote"
tags: ["Public API"]
---

# Quote Video Generation

`POST /v1/video-generations/quote`

## 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/v1/video-generations/quote`
- Auth: HTTP bearer

## Request body

- VideoGenerationQuoteRequest
  - `video` VideoOptions
    - `model` string, nullable: provider:model ID from GET /models; omission uses the configured default model.
    - `duration_seconds` number, nullable: Seconds; choose a supported duration for the model and resolution. Omission uses its default.
    - `resolution` string, nullable: Resolution value from the live model catalog.
    - `ratio` string, nullable: Aspect ratio supported by the current model and input mode.
    - `seed` integer, nullable: Optional seed only for models advertising seed support; not a universal determinism guarantee.
    - `style_preset` string, nullable: Optional style preset supported by the selected provider/model.
    - `watermark` boolean, nullable: Optional watermark setting; check the model capability.
    - `transparency` GenerationTransparency
      - `mode` 'standard' | 'alpha_key': standard keeps the scene; alpha_key requires meaningful alpha in all active input images. Raw videos remain opaque.
      - `key_color` string, nullable: Temporary key color when using manual selection; normally leave automatic selection enabled.
      - `key_selection` 'auto' | 'manual': How the temporary key color is selected.
    - `input_canvas` object, nullable: Optional input framing; omit to keep the source framing.
      - `enabled` boolean: Whether to prepare an expanded input canvas.
      - `source_scale` number: Source subject scale within the canvas.
      - `position_x` number: Normalized horizontal source position.
      - `position_y` number: Normalized vertical source position.
      - `aspect_ratio` 'follow_output' | 'source': Follow the output ratio or preserve the source ratio.
      - `background` 'auto' | 'transparent' | 'solid': Canvas extension background strategy.
      - `background_color` string, nullable: Six-digit RGB color for a solid extension.
  - `has_last_frame` boolean: Whether the planned request includes a last frame.
  - `reference_image_count` integer: Number of additional references, excluding the first frame.

## Response `200`

Successful Response

- QuoteResponse
  - `object` 'quote'
  - `credits` integer, required: Current estimated credits. No price lock or spend authorization; creation recalculates the quote.
  - `breakdown` object: Public cost components; use credits as the quoted total.
  - `resolved_export` object, nullable: Final sampling summary for an FPS export from an existing source; null for legacy or generation quotes.
    - `selection` Selection, required
      - `mode` 'full' | 'range': full uses the complete source; range requires duration_seconds.
      - `start_seconds` number: Range start in seconds from the source beginning.
      - `duration_seconds` number, nullable: Required when mode=range; positive interval length in seconds.
    - `fps` number, required: Target sampling frequency; never recalculated as frame_count / duration.
    - `frame_count` integer, required: Number of samples strictly before the selected end.
    - `duration_ms` integer, required: Sum of manifest frame durations in milliseconds.
    - `warnings` ExportWarning[]: Sampling warnings, including repeated source frames without interpolation.
      - `code` string, required
      - `message` string, required
      - `details` object

## Other responses

- `422`: Validation Error

---

[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/ac3744fbb14e?raw)