Image Face Swap API for Production Workflows
Add consent-based face replacement to image pipelines through the GoEnhance API. Submit a target image and a source face, store the returned task ID, then poll or receive callbacks until the result reaches a terminal state.
Get API Access
A focused image face swap API contract
Submit the two required images
Send reference_img as the target image and source_img as the face image. Both are required HTTPS image URLs, and the current API reference documents a 5 MB maximum for each input.
Track completion without blocking
A successful submission returns an img_uuid. Query GET /api/v1/jobs/detail or supply a public HTTPS callback URL and handle pending, processing, success, and failed outcomes explicitly.
Build around the documented request, task, and result contract.
Capabilities that matter in production
Bearer-authenticated requests
Keep the GoEnhance API key on your server and send it in the Authorization header. Never expose production credentials in browser code.
Explicit target and source roles
Use <code>reference_img</code> for the target composition and <code>source_img</code> for the face to transfer, preventing common input-order mistakes.
HTTPS asset validation
Validate that both image URLs are reachable by the API and remain within the documented 5 MB limit before creating a task.
Asynchronous task IDs
Persist the returned <code>img_uuid</code> so workers, retries, callbacks, and customer-facing status checks all refer to the same job.
Polling or callbacks
Poll the job detail endpoint with backoff, or accept status-change callbacks at a publicly reachable HTTPS endpoint.
Typed result handling
Inspect each result entry by <code>type</code> instead of assuming the first item is always an image URL, and copy expiring outputs into your own approved storage.
Use current account pricing and balance data as the source of truth.
Image face swap API pricing without guesswork
Check live image face swap API pricing
The current public endpoint reference does not publish a fixed per-image token rate. Confirm the live charge on the GoEnhance billing page before forecasting spend rather than relying on an invented or stale number.
Monitor token balance
Use <code>GET /api/v1/user/tokens</code> to read the available balance from <code>data.count</code> and trigger internal alerts before jobs are submitted.
Set application-level budgets
Record task creation and terminal outcomes, cap usage by tenant, and reconcile billed activity against your GoEnhance account pricing.
Integrate the GoEnhance API in three steps
1
1. Validate consent and inputs
Confirm you have permission to use both faces, verify HTTPS access, enforce the documented file-size limit, and reject unsupported or ambiguous assets before submission.
2
2. Create and persist the task
POST the two image URLs to
/api/v1/imagefaceswap/generate, check both HTTP and response-level success, and store the returned img_uuid. 3
3. Resolve and store the result
Poll with backoff or verify callback deliveries, branch on terminal status and result type, then move successful output into durable storage before temporary links expire.
Treat consent, disclosure, and access control as product requirements—not optional copy.
Useful, permission-based use cases
Consented campaign personalization
Generate approved creative variations for talent, ambassadors, or customers who have explicitly authorized image use.
Film and previsualization
Create internal concept frames or casting previews while keeping final review and rights clearance in the production process.
Localized creative workflows
Adapt approved visual assets for regional campaigns while retaining traceable source permissions and human review.
Avatar and profile experiences
Power opt-in avatar experiments where users knowingly provide both the target image and source face.
Creative prototyping
Test layouts and visual directions before commissioning final photography, without presenting synthetic output as an authentic event.
Moderated media tools
Add face swap to controlled applications with consent checks, abuse reporting, retention rules, and review gates around generation.
Practical answers for integration, pricing, task handling, and responsible use.