> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viggle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 透明背景输出

> 生成用于视频合成的 Alpha 输出。

将 `background_mode` 设为 `transparent`，即可生成用于合成的主视频和 Alpha 蒙版。

```bash theme={null}
curl -X POST "https://apis.viggle.ai/v1/renders" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "image=@character.png" \
  -F "motion_video=@motion.mp4" \
  -F "background_mode=transparent"
```

渲染就绪后，响应中包含：

```json theme={null}
{
  "status": "ready",
  "video_url": "https://...",
  "alpha_url": "https://..."
}
```

在编辑器中将 `video_url` 用作前景视频，将 `alpha_url` 用作其蒙版。若使用绿幕流程，请设置 `background_mode=solid`，并将 `bg_color` 设为 `0,255,0`。