1. Pixverse
梧柏API使用文档
WHBAI · Pixverse
  • WHBAI · Google Gemini 原生 (v1alpha)
  • WHBAI · Google Gemini 原生
  • WHBAI · Ideogram
  • WHBAI · Ideogram V3
  • WHBAI · Midjourney
  • WHBAI · Jimeng
  • WHBAI · Kling
  • WHBAI · Luma
  • WHBAI · Luma V1
  • WHBAI · Omni 视频
  • WHBAI · Pixverse
  • WHBAI · Runway
  • WHBAI · Sora2
  • WHBAI · 统一视频 VEO
  • WHBAI · Vidu
  • WHBAI · 豆包 Volc
  • WHBAI · Suno
  • WHBAI · Playground
  • WHBAI · 账号与令牌
  • WHBAI · 阿里 Pix
  • WHBAI · 阿里百炼
  • WHBAI · 私域人像
  • WHBAI · Fal.ai
  • WHBAI · Replicate
  • WHBAI · 腾讯云 VOD
  • WHBAI · MiniMax
  • WHBAI · 支持模型列表
  • WHBAI · Grok Imagine
  • WHBAI · Seedance 2.0
  • WHBAI · TypeSafe
  • WHBAI · OpenAI 兼容
  • Pixverse
    • 模板生图
      POST
    • 文生视频
      POST
    • 图生视频
      POST
    • 转场视频
      POST
    • 视频延长
      POST
    • 融合视频
      POST
    • 对口型
      POST
    • 换脸/换人
      POST
    • 动作模仿
      POST
    • 视频修改
      POST
    • 风格重绘
      POST
    • 音效生成
      POST
    • 多段转场
      POST
    • 上传图片
      POST
    • 上传媒体
      POST
    • Mask 选择
      POST
    • 查询视频任务
      GET
    • 查询图片任务
      GET
    • TTS 音色列表
      GET
  • 数据模型
    • PixverseSampleRequest
    • PostOpenapiV2VideoTextGenerateRequest
    • PostOpenapiV2VideoImgGenerateRequest
    • PostOpenapiV2VideoTransitionGenerateRequest
    • PostOpenapiV2VideoExtendGenerateRequest
    • PostOpenapiV2VideoFusionGenerateRequest
    • PostOpenapiV2VideoLipSyncGenerateRequest
    • PostOpenapiV2VideoSwapGenerateRequest
    • PostOpenapiV2VideoMimicGenerateRequest
    • PostOpenapiV2VideoModifyGenerateRequest
    • PostOpenapiV2VideoRestyleGenerateRequest
    • PostOpenapiV2VideoSoundEffectGenerateRequest
    • PostOpenapiV2VideoMultiTransitionGenerateRequest
    • NewApiError
  1. Pixverse

Mask 选择

POST
/openapi/v2/video/mask/selection
获取视频遮罩,返回 mask_id 供视频编辑等接口使用。

网站中的模型与调用示例#

主体替换(Swap) Mask 生成#

请求参数#

{
  "contentType": "application/json",
  "properties": {
    "keyframe_id": {
      "description": "从1 到最后视频帧. 如果不提供默认为1",
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "From 1 to the last video frame. Defaults to 1 if not provided"
        }
      }
    },
    "source_video_id": {
      "description": "通过拍我API 生成的video_id, 必传source_video_id 或 video_media_id\n编码需要为 h.264/h.265",
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "The video_id generated by Paiwo API must be passed in source_video_id or video_media_id\nEncoding needs to be h.264/h.265"
        }
      }
    },
    "video_media_id": {
      "description": "通过接口上传的视频 media_id,必传source_video_id 或 video_media_id",
      "type": "integer",
      "x-i18n": {
        "en-US": {
          "description": "For videos uploaded through the interface media_id, source_video_id or video_media_id must be passed"
        }
      }
    }
  },
  "required": []
}

请求示例 · 示例 1#

{
  "keyframe_id": 1,
  "source_video_id": 0
}

请求参数

Authorization
Bearer Token
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
or
Body 参数application/json必填

示例
{
    "keyframe_id": 1,
    "source_video_id": 0
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/v2/video/mask/selection' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "keyframe_id": 1,
    "source_video_id": 0
}'

返回响应

🟢200成功
application/json
成功
Bodyapplication/json

示例
{
    "ErrCode": 0,
    "ErrMsg": "success",
    "RespData": {
        "id": 123456
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:15
上一页
上传媒体
下一页
查询视频任务
Built with