Video Face Swap API for Production Workflows
Add permission-based face replacement to video pipelines through the GoEnhance API. Submit a target video, a source face image, output settings, and a timed segment; then persist the returned task ID and resolve the asynchronous result.
Get API Access
A focused video face swap API contract
Prepare the timed video request
Send reference_video as the target clip and reference_img as the face image. The current reference documents maximum sizes of 200 MB and 5 MB, plus required start_time, end_time, and upscaler fields.
Resolve completion asynchronously
A successful submission returns data.img_uuid. Poll GET /api/v1/jobs/detail or provide a public HTTPS callback, handle pending, processing, success, and failed states, and inspect typed result entries before storing the final video.
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 media roles
Use <code>reference_video</code> for the target clip and <code>reference_img</code> for the face to transfer, preventing common input-order mistakes.
Bounded source assets
Validate accessible media before submission. The current endpoint reference documents a 200 MB video maximum and a 5 MB image maximum.
Timed conversion segments
Provide <code>start_time</code> and <code>end_time</code> from 0 to 120 seconds, and validate that the selected interval is meaningful for the source clip.
Output and enhancement controls
Choose <code>upscaler</code> 1 for 720p or 2 for VIP-only 1080p, and enable <code>enhance_face</code> only when the workflow requires it.
Typed asynchronous results
Persist <code>img_uuid</code>, handle all terminal states, inspect result entries by <code>type</code>, and copy successful output before temporary links expire.
Use the live billing page and account balance as the source of truth.
Video face swap API pricing without guesswork
Check live video face swap API pricing
The endpoint reference documents cost multipliers but not a fixed base rate. Confirm the current base charge on the GoEnhance billing page before forecasting spend.
Account for optional multipliers
The current reference marks 1080p output and face enhancement as 1.5x-price options. It does not explain how combined options are calculated, so verify the live charge rather than assuming.
Monitor credits and budgets
Use <code>GET /api/v1/user/tokens</code> to read <code>data.count</code>, then add per-tenant limits, task ledgers, and alerts around your current GoEnhance API pricing.
Integrate the GoEnhance API in three steps
1
1. Validate permission and media
Confirm consent and usage rights, verify that both URLs are reachable, enforce documented size and time bounds, and reject unsupported or ambiguous inputs before submission.
2
2. Create and persist the task
POST the required media, time range, and output setting to
/api/v1/videofaceswap/generate; check HTTP and response-level success, then store data.img_uuid. 3
3. Track, verify, and store output
Poll with backoff or verify callback deliveries, branch on terminal status and result type, review the swap for identity and frame consistency, then move approved output into durable storage.
Treat consent, disclosure, and access control as product requirements, not optional copy.
Useful, permission-based use cases
Consented campaign variants
Create approved video variants for talent, ambassadors, or customers who have explicitly authorized use of their likeness.
Film previsualization
Prototype casting or scene continuity before final production while keeping human review and rights clearance in the workflow.
Localized creative production
Adapt approved footage for regional campaigns while retaining traceable source permissions, disclosure, and review records.
Opt-in entertainment tools
Power experiences where users knowingly provide the target clip and source portrait and understand that the result is synthetic.
Controlled internal prototypes
Evaluate framing and concept direction without presenting generated footage as an authentic event or real endorsement.
Moderated media applications
Combine face swapping with access controls, abuse reporting, retention limits, provenance records, and approval gates.
Practical answers for integration, pricing, task handling, and responsible use.