---
title: "Generate Video Endpoint"
method: POST
path: "/api/v1/video/generate"
tags: ["Video"]
---

# Generate Video Endpoint

`POST /api/v1/video/generate`

## Request

- Base URL: `https://mockupper.damdafa.com/mockupper`
- URL: `https://mockupper.damdafa.com/mockupper/api/v1/video/generate`
- Auth: HTTP bearer

Start a video generation job.

## Headers

- `ProviderId` 'firebase' | 'google' | 'apple'
- `X-Provider-Id` 'firebase' | 'google' | 'apple'
- `X-Device-Id` string, nullable

## Request body

- VideoGenerateRequest: Schema for the video generation API request.
  - `projectId` string, required
  - `versionId` string, required
  - `screenshotGroupId` string, nullable: The screenshot group to use as context for the video.
  - `prompt` string, nullable: Optional specific user instruction/concept
  - `guideImageUrls` string[], nullable
  - `aspectRatio` '9:19.5' | '3:4' | '9:16' | '16:9': Centralized canvas defaults for preview rendering.

## Response `200`

Successful Response

- VideoGenerateResponse: Response returned immediately to the client.
  - `jobId` string, required
  - `status` string, required

## Other responses

- `401`: Unauthorized
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/damdafa/apis/mockupper-api.md) · [All operations](https://skmtc.dev/damdafa/apis/mockupper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/damdafa/apis/mockupper-api/revisions/5713d43bfed1?raw)