你有一条效果很好的视频。现在你想让别人出现在里面：你自己的创作者、一位顾客，或者一个还不存在的人。Hermoso API 一个请求就能做到。发送视频和人物，新的人物就会在同样的节拍和剪辑点上，在同样的房间和光线里，做出原视频里的每个动作、表情和口型。原声保持不变。
一次调用长什么样？
发送视频，以及要出现在里面的人。加上 "dry_run": true 后什么都不会运行，返回的就是准确价格。
curl -sX POST https://app.hermoso.ai/v1/recasts \
-H "Authorization: Bearer hmk_..." \
-H 'content-type: application/json' \
-d '{
"video": "https://www.tiktok.com/@someone/video/7400000000000000000",
"person": { "describe": "a woman in her 30s, curly dark hair, denim jacket" },
"dry_run": true
}'去掉 "dry_run": true 再发送同样的请求，任务就会开始。你会立刻拿到一个任务，视频做好后就能拿到成片：短片段几分钟，长的会更久。
可以把谁放进视频？
- 你保存的创作者，或某个现成的 AI 创作者，用 ID 指定。
- 这个人的照片，用链接指定。
- 用文字描述的 AI 人物。描述他们的年龄、发型、风格和气质，Hermoso 会先生成这个人，再把他们放进视频。人物会保存到你的资料库，可以重复使用。
还想换个声音？可以用同样的台词和节奏配上新的声音，或者让他们说另一种语言，口型和新台词对得上。都在同一个请求、同一个任务里完成。
哪些视频可以用？
TikTok、Reel、Facebook、X 或 YouTube 链接，视频文件链接，或者你上传到 Hermoso 的文件。一次调用最多处理 60 秒，你也可以指定开始和结束时间来选一个片段。
要花多少钱？
价格取决于视频长度，以及是否加新的声音，所以我们从不估算。试运行会在运行任何内容前，按步骤给你准确价格。真正的调用会预留这笔金额，并按渲染实际花费结算，绝不会更多。一个积分值多少，请看价格页。
可以换物品而不是换人吗？
可以。第二个端点用一句简单的指令改变片段里的一样东西：“只把杯子改成红色”、“把瓶子换成我们的产品”、“改成夜晚”。动作、节奏和构图都保持不变。附上真实产品或材质的图片，改动就会和它一致。
curl -sX POST https://app.hermoso.ai/v1/edits \
-H "Authorization: Bearer hmk_..." \
-H 'content-type: application/json' \
-d '{ "video": "https://example.com/clip.mp4", "instruction": "change only the mug to red", "dry_run": true }'不确定效果如何？可以先要一张静帧预览。你会在单帧上看到改动，旁边附上整段片段的价格，只有你确认后片段才会运行。
为你的后端而做
- 异步。真正的调用会立刻返回一个任务。你可以查询任务，或给我们一个链接，我们把成片发给你。
- 放心重试。再次发送同一个幂等键，返回的是同一个任务，绝不会重复渲染。
- 清楚的拒绝。无法运行时，会在扣费前告诉你原因，并附上你的代码可以据此分支的错误码。
- 一个 API 密钥，在应用里创建，MCP 服务器和命令行用的也是同一个。
真实的人怎么办？
使用真实人物的照片需要付费套餐，发送照片即表示你已获得本人许可。用文字描述的 AI 人物或现成的 AI 创作者，所有套餐都能用。会把某人放进他们绝不该出现的场景的请求，会在运行前被拒绝。
更喜欢点按而不是写代码？
同样的换人功能也在应用里，见替换视频中的人物，你的 AI 智能体也可以通过 MCP 运行它。三种方式用的是同一个引擎，价格也一样。
常见问题
什么是动作迁移 API？
它接收一条视频和另一个人，返回由这个人出演的视频，完全照着原来的人做：同样的动作、表情、节奏和剪辑。Hermoso 的版本还会保留原声，也可以给新的人物换上新的声音或语言。
一次换人要多少钱？
取决于视频长度，以及是否加新的声音。带上 dry_run 发送请求，在运行任何内容前你就能拿到准确价格。真正的调用绝不会收得更多。
可以用真实人物的照片吗？
可以，需要付费套餐，并且只能在获得本人许可的情况下使用。发送照片即表示你已获得许可。根据描述生成的 AI 人物或现成的 AI 创作者，所有套餐都能用。
需要多长时间？
取决于长度：短片段几分钟，长片段或加了新声音的会更久。调用会立刻返回一个任务，你可以查询它，或让成片发送到你指定的链接。
可以换物品而不是换人吗？
可以。edits 端点用一句简单的指令改变片段里的一样东西，比如改变杯子的颜色，或把瓶子换成你的产品，其余一切保持原样。