1. 解决方案
拍我AI 开放平台
  • 开始使用
    • API介绍
    • 模型能力地图
    • 了解计费和用量
    • 快速开始
    • 联系我们
    • 服务条款
    • 隐私政策
  • API
    • 前置准备
      • 开始使用
      • 并发规则
      • 查询任务状态说明
      • 错误码
      • FAQ
      • Webhook 回调
      • 上传图片
      • 上传资源(视频/音频)
      • 获取特效模板列表
      • 获取 TTS 音色列表
      • 获取视频重绘列表
      • 获取用量扣减情况
      • 查询任务状态
    • 基础能力
      • 文生视频
      • 图生视频 / 视频模板
      • 图片模版生成
      • 首尾帧生成视频
      • 多主体多参考图 / 视频参考
      • 智能多帧 / 多帧过渡视频
      • 视频延长 Extend
    • 解决方案
      • 超清视频
        POST
      • 视频重绘 Restyle
        POST
      • 对口型 Lipsync
        POST
      • 音效生成 Sound Effect
        POST
      • Mask 生成
        POST
      • 主体替换 Swap
        POST
      • 视频编辑 Modify
        POST
      • 动作模仿 Motion Control
        POST
      • 图片数字人 Avatar
        POST
      • 爆款复刻 Agent
        POST
      • 房产视频一键成片Agent
        POST
      • 一键音乐MV(Music Video)
        POST
  • 计费
    • PixVerse API 计费规则
  • 更新日志
    • 更新日志
  1. 解决方案

Mask 生成

POST
/openapi/v2/video/mask/selection
根据视频关键帧和文本描述识别目标主体或区域并生成遮罩。请求时通过 source_video_id 或 video_media_id 指定源视频,填写 keyframe_id 与 mask_prompt;返回的遮罩结果可用于主体替换等后续视频编辑能力。

请求参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200
application/json
请求已受理;请同时检查 ErrCode。
Bodyapplication/json

请求示例请求示例
Shell
curl --location 'https://app-api.pixverseai.cn/openapi/v2/video/mask/selection' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Content-Type: application/json' \
--data '{
    "source_video_id": 123456789,
    "video_media_id": 987654321,
    "keyframe_id": 1,
    "mask_prompt": "the person in the center"
}'
响应示例响应示例
{
    "ErrCode": 0,
    "ErrMsg": "Success",
    "Resp": {
        "property1": "string",
        "property2": "string"
    }
}
修改于 2026-09-04 06:46:31
上一页
音效生成 Sound Effect
下一页
主体替换 Swap
Built with