上传资源（视频/音频）
POST
/openapi/v2/media/upload
上传资源（视频/音频）
media_id，后续在视频延长、视频重绘、视频编辑、动作模仿、对口型、音效生成等接口中使用。适用场景
| 使用场景 | 后续接口 |
|---|---|
| 延长已有视频 | 视频延长 （Extend） |
| 使用提示词修改已有视频 | 视频编辑 （Modify） |
| 改变视频风格 | 视频重绘 （Restyle） |
| 替换视频主体 | 主体替换 （Swap） |
| 动作模仿 | 动作模仿 （Motion Control） |
| 对口型 | 对口型 （Lipsync） |
| 音效生成 | 音效生成 （Sound Effect） |
| 超清处理 | 超清视频 |
接入流程
准备视频 / 音频文件或资源 URL
-> 调用上传资源 API
-> 获取 media_id
-> 在对应视频编辑或音频相关接口中传入 media_id接口地址
请求参数
| 参数 | 类型 | 是否必填 | 示例 | 说明 | 限制条件备注 |
|---|---|---|---|---|---|
file | file | 条件必填 | /path/to/video.mp4 | 本地视频或音频文件，与 file_url 二选一 | 支持视频 / 音频格式见下方表格；不同后续能力对文件大小、时长和编码有不同限制 |
file_url | string | 条件必填 | https://example.com/source-video.mp4 | 公网可访问的视频或音频 URL，与 file 二选一 | URL 需可公网访问；资源本身仍需满足格式、大小、时长和编码限制 |
素材限制
| 类型 | 支持格式 / mime-type | 限制条件备注 |
|---|---|---|
| 视频 | mp4、mov、webm；支持 video/mp4、video/mov、video/webm、video/quicktime | 视频分辨率最长边最高支持 1920px；部分能力对编码、大小和时长有额外要求 |
| 音频 | mp3、wav、m4a、aac；支持 audio/mpeg、audio/wav、audio/vnd.wave、audio/x-wav、audio/x-m4a、audio/aac、audio/x-aac、audio/wave、audio/mp4 | 音频用于对口型、音效生成等场景；不同能力对音频大小和时长限制不同 |
| 后续能力 | 视频限制 | 音频限制 | 限制条件备注 |
|---|---|---|---|
| 视频延长（Extend） | 最大 50MB；最长 30s | 最大 50MB；最长 30s | 用于已有视频继续生成，建议优先上传主体明确、运动连续的视频 |
| 音效生成 （Sound Effect） | 最大 50MB；最长 30s | 最大 50MB；最长 30s | 可上传视频生成音效，也可结合音频资源使用 |
| 对口型 （Lipsync） | 最大 100MB；最长 60s | 最大 100MB；最长 60s | 需要人物口型清晰；音频建议人声清楚、背景噪声少 |
| 视频重绘 （Restyle） | 最大 50MB；最长 30s | 最大 50MB；最长 30s | 用于改变已有视频视觉风格 |
| 主体替换 （Swap） | 最大 100MB；最长 30s；视频编码需 H.264 / H.265 | 最大 100MB；最长 30s | 适合主体清晰、遮挡较少的视频 |
| 视频编辑 （Modify） | 最大 100MB；最长 30s | 无需音频 | 使用提示词编辑已有视频内容 |
| 动作模仿（Motion Control） | 最大 100MB；最长 30s | 无需音频 | 用参考视频驱动目标主体动作 |
| 超清视频 | 最大 100MB；最长 30s | 无需音频 | 用于视频清晰度增强 |
cURL 示例：上传本地视频
cURL 示例：上传本地音频
cURL 示例：通过资源 URL 上传
字段填写备注
| 字段类型 | 填写建议 |
|---|---|
API-KEY | 使用正式 API Key，不要放在 URL Query 中。 |
Ai-trace-id | 每次请求使用新的 UUID；同一个值重复请求可能被识别为重复任务。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
Resp.media_id | integer | 资源 ID。后续接口使用该资源时，请根据目标接口的请求参数填写，例如视频资源常填入 video_media_id，音频资源常填入 audio_media_id |
Resp.media_type | string | 资源类型，例如 video / audio |
Resp.url | string | 上传后的资源地址 |
响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"media_id": 987654,
"media_type": "video",
"url": "https://..."
}
}注意事项
请求参数
Header 参数
Body 参数multipart/form-data必填
返回响应
请求示例请求示例
Shell
curl --location 'https://app-api.pixverseai.cn/openapi/v2/media/upload' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000' \
--form 'file=@""' \
--form 'file_url="https://example.com/video.mp4"'响应示例响应示例
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"img_id": 0,
"img_url": "https://www.xxx.jpg"
}
}修改于 2026-09-11 07:33:39