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

上传媒体

POST
/openapi/v2/media/upload
multipart 上传视频/音频,返回 media_id 供后续生成接口引用。

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

上传资源(视频/音频)#

1.
支持以下mime/type & 后缀
"video/mp4": "mp4",
"video/mov": "mov",
"video/webm": "webm",
"video/quicktime": "mov"
"audio/mpeg": "mp3",
"audio/wav": "wav",
"audio/vnd.wave": "wav",
"audio/x-wav": "wav",
"audio/x-m4a": "m4a",
"audio/aac": "aac",
"audio/x-aac": "aac",
"audio/wave": "wav",
"audio/mp4": "mp3"
2.
视频文件限制
最大分辨率:1920
最大文件大小:50MB
最大时长:30秒
3.
音频文件限制
最大文件大小:50MB
最大时长:30秒

请求参数#

{
  "contentType": "multipart/form-data",
  "properties": {
    "file": {
      "description": "file or file_url 二选一",
      "example": "",
      "format": "binary",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "file or file_url choose one"
        }
      }
    },
    "file_url": {
      "description": "可以使用url 上传资源. 支持以下mime-type/ 后缀\n\"video/mp4\": \"mp4\", \"video/mov\": \"mov\", \"video/webm\": \"webm\", \"video/quicktime\": \"mov\"\n\"audio/mpeg\": \"mp3\", \"audio/wav\": \"wav\", \"audio/vnd.wave\": \"wav\", \"audio/x-wav\": \"wav\", \"audio/x-m4a\": \"m4a\", \"audio/aac\": \"aac\", \"audio/x-aac\": \"aac\", \"audio/wave\": \"wav\", \"audio/mp4\": \"mp3\"",
      "example": "",
      "type": "string",
      "x-i18n": {
        "en-US": {
          "description": "You can use url to upload resources. The following mime-type/ suffix is supported\n\"video/mp4\": \"mp4\", \"video/mov\": \"mov\", \"video/webm\": \"webm\", \"video/quicktime\": \"mov\"\n\"audio/mpeg\": \"mp3\", \"audio/wav\": \"wav\", \"audio/vnd.wave\": \"wav\", \"audio/x-wav\": \"wav\", \"audio/x-m4a\": \"m4a\", \"audio/aac\": \"aac\", \"audio/x-aac\": \"aac\", \"audio/wave\": \"wav\", \"audio/mp4\": \"mp3\""
        }
      }
    }
  },
  "required": []
}

请求参数

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

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/openapi/v2/media/upload' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

返回响应

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

示例
{
    "ErrCode": 0,
    "ErrMsg": "success",
    "RespData": {
        "id": 123456
    }
}
🟠400请求有误
🟠401没有权限
修改于 2026-10-24 18:33:15
上一页
上传图片
下一页
Mask 选择
Built with