Configure HuggingFace Space for FastAPI with Docker SDK

Dockerfile

@@ -18,10 +18,11 @@ RUN pip install --no-cache-dir -r requirements.txt
 # Copy source
 COPY . .
 
-EXPOSE 8000
+EXPOSE 7860
 
 # Optional: set at runtime
 ENV FACE_SWAP_API_KEY=""
 
-CMD ["python3", "-m", "uvicorn", "fastapi_app:app", "--host", "0.0.0.0", "--port", "8000"]
+CMD ["python3", "-m", "uvicorn", "fastapi_app:app", "--host", "0.0.0.0", "--port", "7860"]
+
 

README.md

@@ -3,9 +3,9 @@ title: FaceSwapAll
 emoji: 🏆
 colorFrom: green
 colorTo: indigo
-sdk: gradio
+sdk: docker
 sdk_version: 5.29.0
-app_file: app.py
+app_file: Dockerfile
 pinned: false
 license: unknown
 short_description: 'All-in-one face swapping: single photo, video, multi-source,'

combined_app.py

@@ -0,0 +1,22 @@
+"""
+Combined app that runs both Gradio UI and FastAPI endpoints.
+This allows HuggingFace Spaces to serve both the UI and API.
+"""
+import os
+import sys
+
+# Import FastAPI app
+from fastapi_app import app as fastapi_app
+
+# Import Gradio app
+import gradio as gr
+from app import demo as gradio_demo
+
+# Mount FastAPI app to Gradio
+gradio_demo.mount("/api", fastapi_app)
+
+if __name__ == "__main__":
+    # For HuggingFace Spaces, Gradio will handle the launch
+    # The FastAPI endpoints will be available at /api/*
+    gradio_demo.launch(server_name="0.0.0.0", server_port=7860)
+

main_app.py

@@ -0,0 +1,41 @@
+"""
+Main app for HuggingFace Spaces - FastAPI with Gradio mounted.
+FastAPI endpoints are at root, Gradio UI is at /gradio
+"""
+from fastapi import FastAPI
+from fastapi.middleware.wsgi import WSGIMiddleware
+import gradio as gr
+
+# Import FastAPI app
+from fastapi_app import app as fastapi_app
+
+# Import Gradio app components
+from app import demo as gradio_demo
+
+# Create main FastAPI app
+main_app = FastAPI(title="FaceSwapAll - Combined API and UI")
+
+# Mount FastAPI endpoints (they're already in fastapi_app)
+# We'll include them directly
+main_app.mount("/api", fastapi_app)
+
+# Mount Gradio UI
+main_app.mount("/gradio", WSGIMiddleware(gradio_demo.server))
+
+# Also include health endpoint at root
+@main_app.get("/")
+def root():
+    return {
+        "message": "FaceSwapAll API",
+        "docs": "/docs",
+        "gradio_ui": "/gradio",
+        "api_endpoints": "/api"
+    }
+
+# Re-export for uvicorn
+app = main_app
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+

postman_collection.json

@@ -0,0 +1,481 @@
+{
+	"info": {
+		"_postman_id": "faceswap-api-collection",
+		"name": "FaceSwapAll API",
+		"description": "Complete API collection for FaceSwapAll face swapping service",
+		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
+	},
+	"item": [
+		{
+			"name": "Health Check",
+			"request": {
+				"method": "GET",
+				"header": [],
+				"url": {
+					"raw": "{{base_url}}/health",
+					"host": ["{{base_url}}"],
+					"path": ["health"]
+				}
+			},
+			"response": []
+		},
+		{
+			"name": "Photo Swapping",
+			"item": [
+				{
+					"name": "Single Photo Swap",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_face_idx",
+									"value": "1",
+									"type": "text"
+								},
+								{
+									"key": "destination_face_idx",
+									"value": "1",
+									"type": "text"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/photo",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "photo"]
+						},
+						"description": "Swap a single face from source image to destination image"
+					},
+					"response": []
+				},
+				{
+					"name": "Single Source - Multiple Destinations",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_indices",
+									"value": "1,1,2",
+									"type": "text",
+									"description": "Comma-separated destination face indices (e.g., '1,1,2')"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/photo/single-src-multi-dst",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "photo", "single-src-multi-dst"]
+						},
+						"description": "Swap a single source face onto multiple destination images. Returns ZIP file."
+					},
+					"response": []
+				},
+				{
+					"name": "Multiple Sources - Single Destination",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_face_idx",
+									"value": "1",
+									"type": "text"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/photo/multi-src-single-dst",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "photo", "multi-src-single-dst"]
+						},
+						"description": "Swap multiple source faces onto a single destination image. Returns ZIP file."
+					},
+					"response": []
+				},
+				{
+					"name": "Multiple Sources - Multiple Destinations",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_indices",
+									"value": "1,1,2",
+									"type": "text",
+									"description": "Comma-separated destination face indices (e.g., '1,1,2')"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/photo/multi-src-multi-dst",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "photo", "multi-src-multi-dst"]
+						},
+						"description": "Swap multiple source faces onto multiple destination images. Returns ZIP file."
+					},
+					"response": []
+				},
+				{
+					"name": "Custom Face Mapping",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "mapping",
+									"value": "2,1,3",
+									"type": "text",
+									"description": "Comma-separated mapping (e.g., '2,1,3' means face1->src2, face2->src1, face3->src3)"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/photo/custom-mapping",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "photo", "custom-mapping"]
+						},
+						"description": "Swap faces with custom mapping: map destination faces to specific source images"
+					},
+					"response": []
+				}
+			]
+		},
+		{
+			"name": "Video Swapping",
+			"item": [
+				{
+					"name": "Single Video Swap",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "target_video",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_face_idx",
+									"value": "1",
+									"type": "text"
+								},
+								{
+									"key": "destination_face_idx",
+									"value": "1",
+									"type": "text"
+								},
+								{
+									"key": "add_audio",
+									"value": "true",
+									"type": "text",
+									"description": "Add audio from original video (true/false)"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/video",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "video"]
+						},
+						"description": "Swap a single face from source image onto all frames of target video"
+					},
+					"response": []
+				},
+				{
+					"name": "Swap All Faces in Video",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "target_video",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "num_faces_to_swap",
+									"value": "1",
+									"type": "text",
+									"description": "Number of faces to swap"
+								},
+								{
+									"key": "add_audio",
+									"value": "true",
+									"type": "text",
+									"description": "Add audio from original video (true/false)"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/video/all-faces",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "video", "all-faces"]
+						},
+						"description": "Swap all faces in video with the same source face"
+					},
+					"response": []
+				},
+				{
+					"name": "Video Custom Face Mapping",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "source_images",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "target_video",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "mapping",
+									"value": "2,1,3",
+									"type": "text",
+									"description": "Comma-separated mapping (e.g., '2,1,3')"
+								},
+								{
+									"key": "add_audio",
+									"value": "true",
+									"type": "text",
+									"description": "Add audio from original video (true/false)"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/video/custom-mapping",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "video", "custom-mapping"]
+						},
+						"description": "Swap faces in video with custom mapping: map destination faces to specific source images"
+					},
+					"response": []
+				},
+				{
+					"name": "Single Source - Multiple Videos",
+					"request": {
+						"method": "POST",
+						"header": [
+							{
+								"key": "X-API-Key",
+								"value": "{{api_key}}",
+								"type": "text"
+							}
+						],
+						"body": {
+							"mode": "formdata",
+							"formdata": [
+								{
+									"key": "source_image",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "target_videos",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "target_videos",
+									"type": "file",
+									"src": []
+								},
+								{
+									"key": "destination_indices",
+									"value": "1,2,1",
+									"type": "text",
+									"description": "Comma-separated destination face indices (e.g., '1,2,1')"
+								},
+								{
+									"key": "add_audio",
+									"value": "true",
+									"type": "text",
+									"description": "Add audio from original video (true/false)"
+								}
+							]
+						},
+						"url": {
+							"raw": "{{base_url}}/swap/video/single-src-multi-video",
+							"host": ["{{base_url}}"],
+							"path": ["swap", "video", "single-src-multi-video"]
+						},
+						"description": "Swap a single source face onto multiple videos. Returns ZIP file."
+					},
+					"response": []
+				}
+			]
+		}
+	],
+	"variable": [
+		{
+			"key": "base_url",
+			"value": "https://LogicGoInfotechSpaces-FaceSwapAll.hf.space",
+			"type": "string"
+		},
+		{
+			"key": "api_key",
+			"value": "your_api_key_here",
+			"type": "string"
+		}
+	]
+}
+