eachlabs-face-swap について
eachlabs-face-swapは、EachLabs Predictions APIで画像や動画の顔交換を行うスキルです。モデル選択、入力スキーマの確認、予測状況の取得、結果の取り出し方を扱います。
主な機能
- 01画像の顔交換予測を送信
- 02動画の顔交換予測を送信
- 03記載された顔交換モデルから選択
- 04予測前にモデル入力スキーマを確認
- 05予測状況を照会して出力を取得
活用シーン
- 01対象写真の顔を入れ替える
- 02顔を入れ替えた動画を作成する
- 03タスク送信前にモデル入力を検証する
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ eachlabs/ skills --skill eachlabs-face-swapインストール後、Claude Code で/eachlabs-face-swapを入力して読み込まれたか確認します。
詳細
EachLabs Face Swap
EachLabs Predictions API を使用して、画像や動画間で顔を入れ替えます。
認証
Header: X-API-Key: <your-api-key>
EACHLABS_API_KEY 環境変数を設定します。キーはeachlabs.aiで取得できます。
利用可能なモデル
| モデル | スラッグ | 最適な用途 |
|---|---|---|
| AI Face Swap V1 | aifaceswap-face-swap | 画像の顔交換 |
| Eachlabs Face Swap | each-faceswap-v1 | 画像の顔交換 |
| Face Swap (legacy) | face-swap-new | 画像の顔交換 |
| Faceswap Video | faceswap-video | 動画の顔交換 |
例
AI Face Swap V1 を使った画像の顔交換
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "aifaceswap-face-swap",
"version": "0.0.1",
"input": {
"target_image": "https://example.com/target-photo.jpg",
"swap_image": "https://example.com/source-face.jpg"
}
}'
Eachlabs を使った画像の顔交換
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "each-faceswap-v1",
"version": "0.0.1",
"input": {
"target_image": "https://example.com/target-photo.jpg",
"swap_image": "https://example.com/source-face.jpg"
}
}'
動画の顔交換
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "faceswap-video",
"version": "0.0.1",
"input": {
"target_video": "https://example.com/target-video.mp4",
"swap_image": "https://example.com/source-face.jpg"
}
}'
代替方法:GPT Image v1.5 Edit を使用
プロンプトベースで顔を置き換える場合:
curl -X POST https://api.eachlabs.ai/v1/prediction \
-H "Content-Type: application/json" \
-H "X-API-Key: $EACHLABS_API_KEY" \
-d '{
"model": "gpt-image-v1-5-edit",
"version": "0.0.1",
"input": {
"prompt": "Replace the face in image 1 with the face from image 2. Keep the same pose, lighting, and expression. Maintain natural skin tone and seamless blending.",
"image_urls": [
"https://example.com/target-photo.jpg",
"https://example.com/source-face.jpg"
],
"quality": "high"
}
}'
予測の流れ
- モデルを確認
GET https://api.eachlabs.ai/v1/model?slug=<slug>— モデルが存在することを検証し、正確な入力パラメーターを含むrequest_schemaを返します。適切な入力を指定できるよう、予測を作成する前に必ず確認してください。 - モデルのスラッグ、バージョン
"0.0.1"、スキーマに一致する入力を指定して POSThttps://api.eachlabs.ai/v1/predictionを実行します。 - ステータスが
"success"または"failed"になるまで ポーリングGET https://api.eachlabs.ai/v1/prediction/{id}を実行します。 - 応答から出力画像の URL を 抽出 します。
最良の結果を得るためのヒント
- 顔がはっきり写り、十分に明るい高品質の元画像を使用します。
- 元となる顔画像には、正面または正面に近い角度の、鮮明なポートレートを使用します。
- 元画像と対象画像の照明条件を合わせると、より自然な結果になります。
- プロンプトには「シームレスなブレンド」と「自然な肌の色」を指定します。
- 対象画像では、顔がはっきりと見え、大きく隠れていないことを確認します。
コメント
Markdown 対応