---
title: "Create Video Bg Change Task"
method: POST
path: "/api/v2/video-bg-change/create"
tags: ["video bg change"]
---

# Create Video Bg Change Task

`POST /api/v2/video-bg-change/create`

## Query parameters

- `app_id` string, required
- `guest_id` string, required
- `item` unknown

## Request body

- VideoBgChangeItem
  - `origin_url` string[], required — 源视频地址列表
  - `platform` string — 平台标识
  - `model` string — 模型选择：color/image
  - `mode` string — color 模型速度模式，默认 Fast
  - `background_color` string — 换颜色时使用的背景色
  - `origin_img_url` string[], nullable — 上传图片换背景时的参考图片地址列表
  - `prompt` string, nullable — 上传图片换背景时的提示词
  - `aspect_ratio` string — 上传图片换背景时的视频比例
  - `duration` integer — 时长
  - `resolution` string — Vidu 输出分辨率，可选
  - `bgm` boolean — Vidu 是否开启背景音乐，可选
  - `movement_amplitude` string — Vidu 运动幅度，可选

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/backgroundremove/apis/fastapi.md) · [All operations](https://skmtc.dev/backgroundremove/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backgroundremove/fastapi/revisions/f7e2a01db7f3/schema)