Skip to main content

Model comparisons

Video Face Swap vs Video Head Swap

Only Video Face Swap accepts reference files. Compare Video Face Swap and Video Head Swap tier by tier: prices, request fields and limits.

Video Face Swap

Video Face Swap by SpicyAPI carries the facial features from one reference photo onto the person in a video clip through every frame, keeping their hair, movement, framing and background. Send a video URL and a face image; a style sets the finish.

View model details →View sample outputs →

Video Head Swap

Video Head Swap by SpicyAPI replaces the heads you picked from an analysis with one to three reference photos each, up to 10 heads per request. Body, motion and the original audio stay as shot; the resolution must match the analysis.

View model details →View sample outputs →

Compare

The short answer

Start with the input you have, the result you want and your budget. These are the differences that affect that choice.

  • These tools produce different results. Choose the operation you need first; a lower price does not make one a substitute for the other.
  • Both are listed as Uncensored. Compare the examples and content-test details on each model page for the scenes you want to create.

These tools produce different results. Choose the operation you need first; a lower price does not make one a substitute for the other.

Current price

Price at the same setting

A start price answers a different question than the one you have. These are the tiers both models publish, matched setting for setting, in US dollars per billed unit with no conversion step in between.

These two bill on different tiers, so there is no row to line up. Each one's own published tiers are listed here instead.

Video Face Swap: $0.026 / output seconds

Video Head Swap: 480p $0.064 / output seconds · 720p $0.12 / output seconds

About this comparison

Controls and limits

Every row here is read from the JSON Schema the endpoint validates against, so it matches what the API will really accept rather than a feature list written by hand.

Swipe horizontally to compare all fields.

Video Face Swap vs Video Head Swap
Controls and limitsVideo Face SwapVideo Head Swap
Supported tasksvideo-editvideo-edit
Resolution tiersNot offered480p · 720p
SeedNoYes
ExecutionSubmit, then poll or take the callbackSubmit, then poll or take the callback
Request timeout180 minutes180 minutes
AvailabilityLiveLive

Do low-filter models allow every request?

Content policy, side by side

Two separate facts sit behind these labels. The first is what we do, which is nothing: no platform content filter, and no maturity flag to set on a request. The second is what each model does on its own, and that is the only part that varies between these two.

Video Face Swap

Uncensored

This model declares no content filter. SpicyAPI forwards the request without adding a platform content scan; legal and consent duties remain with the customer.

Video Head Swap

Uncensored

This model declares no content filter. SpicyAPI forwards the request without adding a platform content scan; legal and consent duties remain with the customer.

Use these content labels to shortlist models, then open each model page for available examples and content-test details.

The label never changes your obligations. Age, consent, real-person likeness and the law where you operate stay with you, and SpicyAPI does not inspect each request.

Can I swap the model ID without changing the request body?

Request body, field by field

The task lifecycle is shared; the body is not. Each endpoint publishes its own JSON Schema and the API validates against that, so this is the list to reconcile before a switch.

  • 1 fields appear in both request bodies under the same names. video_url
  • Only Video Face Swap accepts: face_enhance, face_mapping, reference_image_url, style.
  • Only Video Head Swap accepts: analysis_task_id, resolution, seed, swap_targets.
  • Video Face Swap requires reference_image_url, video_url.
  • Video Head Swap requires analysis_task_id, swap_targets.
  • Both reject unknown fields outright, so a parameter left over from the other model comes back as a validation error instead of being quietly ignored.

How to choose

How to choose

Reference-driven workflow

Video Face Swap supports the reference input required for this workflow.

Compare

Moving from one to the other

The model identifiers are spicyapi/face-swap-video-v1/video-edit and spicyapi/head-swap-video-v1/video-edit, and both go in the same field of the same request.

Both run the same way: submit the task, then poll it or take the callback. Queueing and retry logic carry over unchanged.

Both use the same submit-and-track flow, but their required inputs may differ. Check each model page before switching.

One key, one balance, one set of spend caps. Both bill to the same account in US dollars, and the per-key daily, monthly and lifetime limits apply to whichever one you call.

Questions developers ask

Which is cheaper, Video Face Swap or Video Head Swap?

Which is cheaper, Video Face Swap or Video Head Swap?

These tools produce different results. Choose the operation you need first; a lower price does not make one a substitute for the other. Prices may change; check the estimate shown for your actual settings before submitting.

How long can a single request run?

Video Face Swap allows 180 minutes per task and Video Head Swap allows 180. Those are ceilings rather than typical times — most requests finish far sooner — but they are what your own client timeout has to survive.

Prices and capabilities shown here come from the current public model catalogue. Check each model page for its latest inputs and examples.