---
title: "Create Video Bg Remover Task"
method: POST
path: "/api/v2/video-rm-charge/create"
tags: ["video bg remover"]
---

# Create Video Bg Remover Task

`POST /api/v2/video-rm-charge/create`

## Request

- Base URL: `https://api.backgroundremove.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.backgroundremove.io/api/v2/video-rm-charge/create`
- Auth: HTTP bearer

## Query parameters

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

## Request body

- RoutersV2FeaturesVideoBgRemoveV2VideoBgRemoveItem
  - `origin_url` string, required: 源视频地址
  - `output_type` string: 输出类型（兼容字段）
  - `model` string: 模型类型
  - `mask_input` string, nullable: basic/pro 模型所需绿幕视频 URL
  - `type` string: 输入文件类型（video/gif）
  - `chroma_color` string: pro-chroma 颜色
  - `quality_preset` string: pro-chroma 质量预设
  - `gif_fps` integer: basic+gif 输出 gif 帧率
  - `gif_max_colors` integer: basic+gif 输出 gif 最大颜色数
  - `duration_seconds` number, nullable: 时长（秒），OSS 读取失败时必填
  - `resolution` string, nullable: 分辨率，如 1280x720 或 720p；OSS 读取失败时必填
  - `output_format` string: video-pro 输出格式：mov/webm/both
  - `processing_fps` integer: video-pro 处理帧率
  - `max_resolution` integer: video-pro 最长边最大分辨率
  - `background` string: video-pro 背景设置
  - `edge_cleanup` string: video-pro 边缘清理强度
  - `allowed_seconds` number: video-pro 允许处理秒数，并按该秒数计费
  - `use_fp16` boolean: video-pro 是否使用 fp16
  - `keep_alive` boolean: video-pro 是否保持服务存活
  - `disable_safety_checker` boolean: gif-pro 是否禁用安全检查

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/backgroundremove/apis/backgroundremove-api.md) - [All operations](https://skmtc.dev/backgroundremove/apis/backgroundremove-api/llms.txt) - [OpenAPI document](https://skmtc.dev/backgroundremove/apis/backgroundremove-api/revisions/f7e2a01db7f3?raw)
