---
title: "Reference Video Endpoint"
method: POST
path: "/api/videos/reference"
---

# Reference Video Endpoint

`POST /api/videos/reference`

Generate a video using Kling O1 Reference Image to Video.
Creates a container scene with the generated video.

This endpoint uses reference images and elements to generate videos
with consistent characters/objects. Use @Image1, @Image2... and 
@Element1, @Element2... references in the prompt.

Args:
    request: JSON body containing:
        - project_id (str, required): Project ID to add the video to
        - prompt (str, required): Prompt with @Image1, @Image2... and @Element1, @Element2... references
        - image_urls (list[str], optional): List of reference image URLs
        - elements (list[dict], optional): List of element dicts (characters/objects)
            Each element dict commonly includes:
            - "reference_image_urls": list[str]
            - "frontal_image_url": str
        - duration (str, optional): Duration. Only "5" and "10" supported. Default: "5"
        - aspect_ratio (str, optional): Aspect ratio. One of "16:9", "9:16", "1:1". Default: "16:9"
        - max_retries (int, optional): Max retry attempts. Default: 3
        - initial_delay (float, optional): Initial backoff delay. Default: 1.0
    
Returns:
    Success response with scene and video data

## Request body

- object

## Response `202`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/latted/apis/motion-graphics-designer-api.md) · [All operations](https://skmtc.dev/latted/apis/motion-graphics-designer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latted/motion-graphics-designer-api/revisions/36d149b525df/schema)