> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Video Face Swap API

> Transform videos with cinematic-quality face swaps using our advanced AI technology. Integrate seamless face replacement for professional content creation applications.



## OpenAPI

````yaml POST /api/v1/videofaceswap/generate
openapi: 3.1.0
info:
  title: GoEnhance API
  description: ''
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security:
  - bearerAuth: []
tags:
  - name: Basic
  - name: Video2Video
paths:
  /api/v1/videofaceswap/generate:
    post:
      tags: []
      summary: Generate Video Face Swap
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    reference_video:
                      type: string
                      description: target video, Max 200M
                    reference_img:
                      type: string
                      description: target image, Max 5M
                    upscaler:
                      type: integer
                      enum:
                        - 1
                        - 2
                      x-apifox:
                        enumDescriptions:
                          '1': 720p
                          '2': 1080p（仅vip）
                      description: >-
                        Convert video resolution, 1 -> 720p, 2-> 1080p (1.5x
                        price)
                    start_time:
                      type: number
                      description: The start time of the conversion (in seconds)
                      maximum: 120
                      minimum: 0
                    end_time:
                      type: number
                      description: Conversion end time (in seconds)
                      maximum: 120
                      minimum: 0
                    enhance_face:
                      type: boolean
                      description: enable  (1.5x price)
                  required:
                    - reference_video
                    - upscaler
                    - reference_img
                    - start_time
                    - end_time
                  x-apifox-orders:
                    - reference_video
                    - reference_img
                    - frame_rate
                    - upscaler
                    - start_time
                    - end_time
                    - enhance_face
                type:
                  type: string
                  description: mx-video
                  enum:
                    - mx-video-face-swap
                  x-apifox:
                    enumDescriptions:
                      mx-video-face-swap: ''
              required:
                - args
                - type
              x-apifox-orders:
                - args
                - type
            example:
              args:
                reference_video: https://cdn.goenhance.ai/images/static/demo/face-swap-1.mp4
                reference_img: https://cdn.goenhance.ai/images/static/demo/face-swap-1.jpg
                upscaler: 1
                start_time: 0
                end_time: 5
                enhance_face: false
              type: mx-video-face-swap
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                    required:
                      - img_uuid
                required:
                  - code
                  - msg
                  - data
              example:
                code: 0
                msg: Success
                data:
                  img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 401
                msg: Token Error
          headers: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 500
                msg: ''
          headers: {}
      deprecated: false
      security: []
components: {}

````