Photo Face Swap
face-swapReplace one detected face in a target photo with a face from a reference photo. Face detection and cropping are handled automatically.
POST /api/v1/face-swap/submitAsynchronous task APIIndependent deployment switch
The Developer APIs are still in beta and may change at any time. At this stage, they are better suited to personal testing and experimentation and are not yet recommended for production use.
Call the creative AI capabilities enabled for your deployment from code, or use them directly from MCP-compatible tools.
API access is available to subscribers only. Your subscription credits are shared across the website and the API.
I’ll use VidMage to swap the reference face into the target photo.
submit_task · face-swapTask submitted · 1 creditget_task_resultCompleted · imageUrl readyDone — I replaced the face while keeping the target image’s pose, lighting, and background.
Quickstart
Connect Codex, Claude Code, Cursor, and manual clients with persistent, revocable API keys.
Set up VidMage MCP for me.
Core VidMage capability
Photo and video workflows include automatic face detection, reference-face cropping, credit-safe task orchestration, and normalized result URLs.
face-swapReplace one detected face in a target photo with a face from a reference photo. Face detection and cropping are handled automatically.
POST /api/v1/face-swap/submitvideo-face-swapReplace one tracked face in a target video with a face from a reference photo. Detection, landmark tracking, and result parsing are handled automatically.
POST /api/v1/video-face-swap/submitOne platform, two interfaces
Connect Codex, Claude Code, Cursor, and manual clients with persistent, revocable API keys.
Submit a task once, then poll its task ID until the result is ready. Clean JSON in, result URLs out.
The public catalog is generated from the deployment configuration, so discovery, documentation, REST, and MCP always stay aligned.
Create or revoke API keys for Codex, REST, and other MCP clients. Credentials stay tied to your subscription.
Subscribe to unlock API access and start integrating VidMage AI into your products.