{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-CN/reference/ai_video_face_swap.yaml","sidebar":"sidebar-@l10n/zh-CN/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-CN/reference/ai_video_face_swap.yaml","settings":{"baseUrlPath":"/zh-cn/reference/ai_video_face_swap"},"disableAutoScroll":true,"seo":{"title":"AI 视频换脸","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 视频换脸","version":"","description":"# 概览\nAI 视频换脸是一项由 AI 驱动的处理：借助 YouCam 的 AI 视频换脸接口，把视频里一个人的脸换成另一个人的脸。\n在先进 AI 技术的加持下，AI 视频换脸的效果相当逼真。脸部表情、光线、肤色都会精细调校，换上来的脸与原视频画面浑然一体。\n\n> **说明：** 本接口仅支持单人脸视频。需要定制方案，请[联系我们](mailto:YouCamOnlineEditor_API@perfectcorp.com)。\n\n使用示例：\n![](https://plugins-media.makeupar.com/smb/blog/post/2024-08-23/b1f96100-37d6-4c28-b467-d397e9c3a25d.jpg)\n\n![](https://bcw-media.s3.ap-northeast-1.amazonaws.com/dt_yce_video_face_swap_S3_video_03_28785ebe0c.jpg)\n\n![](https://plugins-media.makeupar.com/smb/story/2024-09-12/3582f617-e88e-4219-9e72-43d4c26791cd.png)\n\n---\n\n## 文件规格与错误码\n\n* 支持的格式与尺寸\n\n|AI 功能|支持尺寸|支持文件大小|支持格式|\n|  ----  | ----  | ----  | ----  |\n| AI 视频换脸 | 输入视频不得超过 30 秒、4K 分辨率或 30 FPS；输出限制为长边 1280 分辨率、30 FPS、最长 30 秒。 | 时长上限：30 秒 | 封装格式：mov、mp4 <br>视频编码：MPEG-4、MPEG-4 AVC，<br>音频编码：aac、amr、mp3 |\n\n* 错误码\n\n|错误码|说明|\n|  ----  | ----  |\n| error_download_video | 下载源视频出错 |\n| error_decode_video | 解码源视频出错 |\n| error_unsupported_video | 视频格式不受支持 |\n| exceed_max_filesize | 输入文件大小超出上限|\n| error_nsfw_content_detected | 在源文件中检测到不适宜内容（NSFW） |\n| error_decode_mask | 解码蒙版图片出错 |\n| invalid_parameter | 参数取值无效|\n\n---\n\n## 点数消耗\n\n| AI 功能 | 消耗点数 |\n|---|---|\n| AI 视频换脸 V1.0 | 1（每 5 秒）* |\n\n    > *若图片数量或视频时长不能整除，点数按向上取整计算。\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.199"},"lang":"zh-CN","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-cn/reference/ai_video_face_swap","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}