---
title: "Put your face into a video or a picture — estimate"
method: POST
path: "/v1/ai/face-swap/estimate"
tags: ["Face swap"]
---

# Put your face into a video or a picture — estimate

`POST /v1/ai/face-swap/estimate`

## Request

- Base URL: `https://apihub.co.il`
- URL: `https://apihub.co.il/v1/ai/face-swap/estimate`
- Auth: HTTP bearer

Price the request without executing it. Same body as `POST /v1/ai/face-swap`.

## Request body

- object
  - `hair` 'face' | 'target': The picture engine: keep the hair of the face photo (face) or of the target (target)
  - `seed` integer: Repeat a result exactly
  - `engine` 'auto' | 'wan-replace' | 'seedream': auto (the default) = the better engine for the target: wan-replace for a video (the person in the video becomes the one in the photo, the scene's light kept), seedream for a picture (the face of the photo on the person in the picture, the pose, clothes and scene kept). Name one to compare them
  - `gender` 'male' | 'female' | 'non-binary': The person in face_url — an optional hint for the picture engine
  - `consent` object: The rights / consent declaration for this likeness (or send consent_id)
    - `basis` 'own' | 'consent' | 'licensed': own = it is you / your content · consent = the person gave explicit permission · licensed = you hold the rights to this content
    - `locale` 'he' | 'en' | 'ru' | 'uk': Language the statement was shown in
    - `subject` 'self' | 'other': self = your own face / voice / video · other = another person who agreed
    - `accepted` true, required: You accept the consent statement for this scope (GET the text in the docs or the dashboard)
    - `subject_name` string: Required for `other`: the person's full name
  - `face_url` string, uri, required: A clear photo of the face to put in — your own, or of a person who gave you explicit permission (PNG / JPEG / WebP, one face, up to 15 MB). It is checked first: a public figure or a person who appears to be under 18 is refused
  - `consent_id` string: A consent you recorded before (the dashboard records one when you tick the box)
  - `resolution` '480p' | '580p' | '720p': A video's output resolution (wan-replace). 480p is the cheapest; the price per second grows with it
  - `target_url` string, uri, required: The video (up to 15 s) or the picture to put the face into (public https link — upload it first if needed)
  - `target_type` 'video' | 'image': Whether target_url is a video or a picture — read from the file when omitted
  - `visible_label` boolean: Draw a small "AI" mark in the corner (on by default). The file is always marked as AI-generated in its metadata
  - `duration_seconds` number: The video's length if you know it (only for the estimate; the charge uses the real length)

## Response `200`

Estimate

- Estimate
  - `operation` string
  - `estimated_credits` number
  - `credits_to_reserve` number
  - `estimated_usage` object
  - `note` string, nullable
  - `balance` object
    - `available` number
  - `sufficient` boolean

---

[API](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai.md) · [All operations](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/apihub/apis/apihub-one-api-for-chat-image-video-ai/revisions/a8caa42835ce?raw)