成果の出ている動画があります。今度はそこに別の人を出したい：あなたのクリエイター、お客様、あるいはまだ存在しない人物です。Hermoso APIなら1回のリクエストでできます。動画と人物を送ると、新しい人物が元の動画の動き、表情、口の形をすべて演じます。同じビートとカットで、同じ部屋、同じ光の中で。元の音はそのまま残ります。
1回の呼び出しはどんな形ですか？
動画と、そこに出したい人を送ります。"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にアップロードしたファイル。1回の呼び出しで最大60秒まで扱え、開始と終了を指定して範囲を選ぶこともできます。
料金はいくらですか？
動画の長さと、新しい声を付けるかどうかで変わるので、当て推量はしません。ドライランなら、何かを実行する前に正確な料金をステップごとに確認できます。本番の呼び出しはその金額を確保し、実際のレンダリング費用で精算します。それを超えることはありません。クレジットの価値は料金ページをご覧ください。
人物ではなくモノを差し替えられますか？
はい。2つ目のエンドポイントは、かんたんな指示でクリップ内のものを1つ変えます：「マグカップだけを赤にして」「ボトルを当社の商品に差し替えて」「夜にして」。動き、タイミング、構図はそのままです。本物の商品や素材の画像を添えれば、その見た目に合わせて変わります。
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 }'仕上がりが気になりますか？まず静止画1枚のプレビューを頼めます。1フレームで変化を確認でき、クリップ全体の料金も横に表示されます。クリップはあなたが指示したときだけ実行されます。
バックエンドのために設計
- 非同期。本番の呼び出しはすぐにジョブを返します。ジョブを確認するか、リンクを渡せば完成した動画をお送りします。
- 安全に再試行。同じ冪等キーをもう一度送ると同じジョブが返り、2回目のレンダリングは起きません。
- わかりやすい拒否。実行できないときは、課金の前に理由をお知らせします。コードで分岐できるエラーコード付きです。
- APIキーは1つ。アプリで作成し、MCPサーバーやコマンドラインと同じキーを使います。
実在の人物はどうなりますか？
実在の人物の写真には有料プランが必要で、写真を送ることは本人の許可を得ていることの確認になります。言葉から作るAIの人物や、用意済みのAIクリエイターはすべてのプランで使えます。決して置かれるべきでない場面に誰かを入れるようなリクエストは、何かを実行する前に拒否されます。
コードよりクリックで操作したいですか？
同じ入れ替えはアプリの動画の人物を入れ替えるでも使え、AIエージェントならMCPで実行できます。3つとも同じエンジンで動き、料金も同じです。
よくある質問
モーショントランスファーAPIとは何ですか？
動画と別の人物を受け取り、その人物が元の人物とまったく同じことをする動画を返します。同じ動き、表情、タイミング、カットです。Hermosoのバージョンは元の音も残し、新しい人物に新しい声や言語を付けることもできます。
リキャストの料金はいくらですか？
動画の長さと、新しい声を付けるかどうかで変わります。dry_runを付けてリクエストを送れば、何かを実行する前に正確な料金がわかります。本番の呼び出しでそれ以上請求されることはありません。
実在の人物の写真を使えますか？
はい。有料プランで、その人物の許可がある場合に限ります。写真を送ることが、許可を得ていることの確認になります。説明文から作ったAIの人物や、用意済みのAIクリエイターはすべてのプランで使えます。
どのくらい時間がかかりますか？
長さによります。短いクリップなら数分、長いものや新しい声を付けたものはもう少しかかります。呼び出しはすぐにジョブを返すので、それを確認するか、指定したリンクに完成した動画を送ってもらえます。
人物ではなくモノを変えられますか？
はい。edits エンドポイントは、マグカップの色を変える、ボトルをあなたの商品に差し替えるといったかんたんな指示でクリップ内のものを1つ変え、それ以外はそのまま残します。