本番APIリファレンス
DeepSwapAI AI顔交換API
写真、写真バッチ、グループ写真のマッピング、動画、GIFを同じ本番インターフェースに接続できます。主要な契約、料金単位、タスク状態、境界を確認し、完全なフィールドとレスポンスは英語版リファレンスで確認してください。
1つの契約、5つのワークフロー
HTTPS、multipartアップロード、JSONタスク状態
公開されている生成ルートはすべてBearer APIキーを使い、taskIdを返し、同じルートのGETでタスク状態を確認します。
直接回答
1つのAPIアカウントで5種類の入力に対応
写真、バッチ写真、グループ写真の複数人マッピング、動画、GIFは同じ本番ドメインとタスクライフサイクルを使います。リクエスト前に形式、サイズ、長さ、対象数、クレジットを確認し、送信後はtaskIdを保存して対応するGETルートをポーリングします。
現在公開されている契約
ルート、料金単位、主な制限
| ワークフロー | POSTルート | 料金単位 | 主な制限 |
|---|---|---|---|
| 写真 | POST /api/ai-tasks | 3クレジット / 出力 | 1枚のソース顔画像と1枚の対象画像 |
| 写真バッチ | POST /api/ai-tasks/batch-face-swap | 3クレジット / 出力 | 最大20枚、合計95 MB |
| グループ写真マッピング | POST /api/ai-tasks/multi-face-swap | 3クレジット / 選択した顔 | 最大10顔のマッピング、合計95 MB |
| 動画 | POST /api/ai-tasks/video | 切り上げ秒数ごとに2クレジット、最低6クレジット | MP4、MOV、WebM；300秒；720pまたは1080p |
| GIF | POST /api/ai-tasks/gif | 切り上げ秒数ごとに3クレジット、最低6クレジット | GIF、MP4、WebM；30秒 |
最小統合フロー
リクエストを検証してから生成する
- 1. APIキーはサーバー側に保管し、ブラウザ、モバイルアプリ、ログ、公開リポジトリに置かない。
- 2. ワークフローごとにmultipartフィールド、ファイル形式、サイズ、数、長さ、クレジットを検証する。
- 3. POSTを送信し、返されたtaskIdと想定料金を保存する。
- 4. 同じルートのGETエンドポイントをCOMPLETED、FAILED、CANCELLEDまでポーリングする。
- 5. タスクの所有アカウントだけに結果を渡し、公開された保持ルールに従ってメディアを削除する。
料金、プライバシー、出力
検証できる境界を統合に組み込む
APIはウェブ版と同じ買い切りクレジット残高を使います。失敗した生成タスクは現在の製品ルールに従って自動返金されます。初回購入が完了する前の画像トライアル出力にはDeepSwapAI.comとアカウントの完全なメールアドレスが表示され、購入後に新しく生成する画像だけが対象です。アップロードと生成メディアはサーバーから24時間以内に削除され、アップロード内容はAIモデルの学習に使われません。
開発者向け質問
公開前に確認すること
APIはwebhookに対応していますか？
現在は対応していません。POSTで返されたtaskIdを保存し、同じワークフロールートのGETを終端状態までポーリングします。
公式SDKはありますか？
現在、公式言語SDKは公開されていません。標準HTTPS、Bearer認証、multipart、JSONレスポンスを任意のサーバーHTTPクライアントから呼び出せます。
写真1枚のタスクはいくつのクレジットですか？
写真1枚、バッチの出力1件、グループ写真で選択した顔1件は現在3クレジットです。動画とGIFは切り上げ秒数と最低料金で計算します。
APIキーをフロントエンドに置けますか？
いいえ。APIキーはサーバー側に保管し、ブラウザのバンドル、モバイルバイナリ、ログ、分析イベント、サポートチケットに書き込まないでください。
代表タスク1件で統合を検証する
許可を得た最小のメディアサンプルでフィールド、状態、料金、結果配信を確認してから、バッチや長い動画に拡張してください。