Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
まだ画像はありません。フォームを送信して画像を生成してください。
さまざまなユースケースとパラメータ設定を確認できます
透明な価格設定、隠れた手数料なし。使用量に応じてお支払い。
| ルールとモダリティ | Channel | クレジット | 価格（USD） | 公式/参考価格 | 1日の節約額 |
|---|---|---|---|---|---|
image-face-swap imageapipass | Regular | 5per run | $0.023 | - | - |
image-face-swap の完全ガイド
1 回の API 呼び出しで、本番環境に対応した AI 顔入れ替え機能をアプリに統合できます。
ApiPass の Image Face Swap API を使用すると、写真内の顔を驚くほどリアルな精度でプログラムから置き換えられます。高度な顔認識、位置合わせ、ブレンディングアルゴリズムにより、API はベース画像と参照用の顔画像を受け取り、元写真の照明、ポーズ、表情を保ったまま、クリーンで透かしのない結果を返します。ソーシャルメディアツール、クリエイティブコンテンツプラットフォーム、写真アプリ、エンターテインメント製品のいずれを構築する場合でも、コールドスタートなし、一貫したスループット、シンプルな REST 統合により、大規模でも自然な顔入れ替えを実現できます。
すべてのリクエストには face_image と image が必要です。face_image は本人性のソースを提供し、image は検出された顔を置き換える対象となるターゲット写真です。
target_index は、ターゲット画像内で検出されたどの顔を置き換えるかを選択します。デフォルトは 0 で、整数文字列を受け付け、0 以上である必要があります。
グループポートレートの閉じた目の補正やプロフェッショナルなヘッドショットの作成から、ミーム、性別入れ替え、有名人風の変換、絵画風オーバーレイの生成まで、この API は幅広いクリエイティブおよび商用アプリケーションを支える柔軟性を備えています。
モデルはソース顔とターゲット顔の間で、肌の色、照明方向、影の一貫性を自動的に調整し、合成されたように見えない自然で完全に馴染んだ結果を生成します。手作業でのレタッチは不要です。
元の被写体の頭の傾き、視線方向、表情は入れ替え全体を通じて保持されるため、最終出力はベース写真の文脈に沿った自然で説得力のある仕上がりになります。
写真に複数の人物が写っている場合は、target_index パラメータを使用して、入れ替える顔を正確に指定できます。1 人目、2 人目、3 人目というように選択でき、推測や予期しない結果を避け、毎回一貫した予測可能な結果を得られます。
すべてのレスポンスは、コンシューマー向けアプリ、マーケティング素材、ビジュアルデザインのワークフローですぐに利用できる、透かしのない JPEG、PNG、または WEBP 画像を返します。API パラメータにより、任意で Base64 エンコードや同期モードも利用できます。
統合フローは、ApiPass 上の他の APIPASS 対応非同期画像モデルと同様です。
モデルとして apipass/image-face-swap を選択し、face_image、image、任意の target_index、任意の output_format、任意の enable_base64_output を含む input を準備します。
ペイロードを ApiPass /api/v1/jobs/createTask エンドポイントに送信します。アダプターはモデル名を apipass/image-face-swap に書き換え、正規化されたペイロードを APIPASS に送信します。
/api/v1/jobs/recordInfo を通じてタスクの実行状況を追跡するか、callBackUrl を設定して非同期の完了通知を受信します。
タスクが成功したら、タスクレスポンスオブジェクト内の resultJson.resultUrls から顔入れ替え後の画像 URL を読み取ります。
これらの推奨事項は、アダプターのガードレールと現在の APIPASS パラメータ契約に準拠しています。
顔がはっきり見え、遮られておらず、本人性の詳細を捉えるのに十分な解像度を持つ face_image を選択してください。強いぼけ、極端な角度、強い遮蔽は避けてください。
ターゲット画像に複数の顔が含まれる場合は、再試行時にも指定した置き換えが安定するように、target_index を明示的に設定してください。
enable_sync_mode は false のままにしてください。ApiPass は非同期 webhook/callback システムを利用し、ステータスポーリングと結果処理のためにタスク ID を内部で管理します。
写っている人物の同意がある場合に、アバター、プロフィール画像、キャンペーンのモックアップ、社内のビジュアルテスト向けに承認済みのポートレートバリエーションを作成します。
選択した本人性ソースとターゲット構図を組み合わせて、キャラクター、衣装、シーンのコンセプトをプレビューします。
顧客の顔をプロのモデル画像に入れ替えることで、商品を身につけた自分の姿を確認できるようにし、購入への安心感を大きく高め、返品率を低減します。
このドキュメントでは apipass/image-face-swap を使用しています。これは、コードベースとサンプルスクリプトで使用されている現在の SUPPORT_MODEL 値であるためです。
readme と API セクションでは、ApiPass が apipass/image-face-swap を ApiPass の apipass/image-face-swap エンドポイントへ転送することを説明しており、get_provider_model_name と一致しています。
この JSON は、face_image、image、target_index、output_format、enable_base64_output、enable_sync_mode について、アダプターに実装されているものと同じ検証内容を記載しています。
すべてのAPIはBearer Tokenによる認証が必要です。
Authorization: Bearer
ApiPass の統合 jobs API を通じて新しい Image Face Swap タスクを作成します
ApiPass は公開リクエストのエンベロープを安定的に維持します。顔交換パラメーターは input オブジェクト内で渡され、WaveSpeed アダプターによって正規化されます。
1{
2 "model": "apipass/image-face-swap",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "face_image": "https://example.com/face.jpeg",
6 "image": "https://example.com/target.jpeg",
7 "target_index": 0,
8 "output_format": "jpeg",
9 "enable_base64_output": false,
10 "enable_sync_mode": false
11 },
12 "channel": "auto"
13}model必要stringImage Face Swap 用の公開 ApiPass モデル名。
"apipass/image-face-swap"
callBackUrlオプションstringApiPass タスク完了通知用の任意のユーザー callback URL。
"https://your-domain.com/api/callback"
channelオプションstringchannel パラメーターを使用して、APIPASS 内の対応するプロバイダーを指定できます。これらのプロバイダーが実際の画像および動画生成タスクを処理します。APIPASS は現在、3 つのプロバイダーオプションを提供しています：
channel パラメーターのデフォルト値は auto です。有効にすると、APIPASS はリアルタイムの価格と安定性指標に基づいて、利用可能なプロバイダー間でタスクを自動的に割り当て、最小コストと信頼性の高いパフォーマンスのバランスを取ります。カスタムルーティング要件がない限り、デフォルトの auto 値を維持してください。
利用可能なオプション：
auto
input オブジェクトには、WaveSpeed アダプターが受け付ける顔交換パラメーターが含まれます。
input.face_image必要string | array<string>ソース顔画像の URL。直接 API リクエストでは文字列を送信できます。Playground アップローダーは単一要素の配列を送信し、アダプターは最初の空でない URL を使用します。
"https://static.wavespeed.ai/examples/face.jpeg"
input.image必要string | array<string>ターゲット画像の URL。直接 API リクエストでは文字列を送信できます。Playground アップローダーは単一要素の配列を送信し、アダプターは最初の空でない URL を使用します。
"https://static.wavespeed.ai/examples/source.jpeg"
input.target_indexオプションnumber置き換えるターゲット顔の 0 始まりのインデックス。デフォルトは 0 です。アダプターは "2" などの整数文字列を受け付け、負の値は拒否します。
0
input.output_formatオプションstring任意の出力形式。このフィールドが存在する場合、アダプターは空でない文字列を要求し、jpg を jpeg に正規化します。
利用可能なオプション：
"jpeg"
input.enable_base64_outputオプションbooleanWaveSpeed から base64 出力を要求するかどうか。デフォルトは false です。ApiPass は成功した出力を resultJson.resultUrls に変換します。
false
input.enable_sync_modeオプションbooleanプロバイダー互換性のために受け付けますが、ApiPass は webhook モードでタスクを送信するため、WaveSpeed アダプターはこれを false に強制します。
false
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "apipass/image-face-swap",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "face_image": "https://static.wavespeed.ai/examples/0e20bb80259f4840ba394ec2e7f213be/1752459933783339486_bT840WSP.jpeg",
9 "image": "https://static.wavespeed.ai/examples/0e20bb80259f4840ba394ec2e7f213be/1752459923195240956_OHfc951Y.jpeg",
10 "target_index": 0,
11 "output_format": "jpeg",
12 "enable_base64_output": false,
13 "enable_sync_mode": false
14 }
15 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_image_face_swap_1767168190655"
6 }
7}codeステータスコード。200 は ApiPass タスクが正常に作成されたことを示します。
messageApiPass によって返されるレスポンスメッセージ。
data.taskId後続のステータス確認に使用するタスク識別子。内部的には、アダプターが WaveSpeed のリクエスト ID をプロバイダーのタスク ID として保存します。
flux
flux
Generate photorealistic images with robust text
開始価格
0 クレジット
Nano Banana 2 Lite, aka Gemini 3.1 Flash-Lite Image, is a newly released image model from Google DeepMind built for fast 1K image generation, efficient creative iteration, prompt-based image editing, and responsive visual output in product-facing creative scenarios.
開始価格
0 クレジット
OpenAI
OpenAI
Generate intentionally designed visuals with less prompting using the latest OpenAI GPT Image 2 model.
開始価格
0 クレジット
Fast image generation model built on Gemini 3.1 Flash Image. Supports text-to-image, image editing, multi-image fusion with up to 14 reference images, Google Search grounding, and outputs up to 4K resolution.
開始価格
0 クレジット
apipass
apipass
Seamlessly remove watermarks, logos, and unwanted text from your images at scale with our powerful AI-driven API.
開始価格
0 クレジット
seedream
seedream
開始価格
0 クレジット
grok
grok
Grok Imagine is xAI’s AI video generation model for creating high-quality videos with realistic motion, native audio, and synchronized speech. Grok Imagine 1.5 introduces faster generation speeds, improved motion physics, and stronger visual consistency for modern AI video applications.
開始価格
0 クレジット
seedream
seedream
開始価格
0 クレジット
OpenAI
OpenAI
Bring your ideas to life with sharper, faster, more precise image generation using the GPT Image 2.5 API.
開始価格
0 クレジット
Luma
Luma
開始価格
0 クレジット
seedream
seedream
開始価格
0 クレジット