---
title: "Create video"
method: POST
path: "/v1/videos"
tags: ["relay"]
---

# Create video

`POST /v1/videos`

Create a video generation job

## Headers

- `Aiproxy-Channel` string

## Request body

- ModelVideosRequest
  - `input_reference` string
  - `model` string
  - `prompt` string
  - `seconds` unknown
  - `size` string

## Response `200`

OK

- ModelVideo
  - `created_at` integer
  - `error` object
  - `id` string
  - `model` string
  - `object` string
  - `progress` integer
  - `prompt` string
  - `seconds` integer
  - `size` string
  - `status` 'queued' | 'in_progress' | 'completed' | 'succeeded' | 'failed' | 'cancelled'

## Changes

- **2026-05-21** `844bb1ee4ae4` — 1 info
  - endpoint added
- **2025-05-23** `544096a3f194` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/changes/v1/videos/post.md)

---

[API](https://skmtc.dev/labring/apis/ai-proxy-swagger-api.md) · [All operations](https://skmtc.dev/labring/apis/ai-proxy-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/labring/ai-proxy-swagger-api/revisions/696faf563b42/schema)