> ## 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:
                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)
                custom_callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional. A publicly accessible HTTPS URL. When the task
                    status changes (processing / success / failed), GoEnhance
                    sends a POST request to this URL. The request body is
                    identical to the response of GET /api/v1/jobs/detail. If
                    your server does not respond with HTTP 200, the notification
                    is retried up to 3 times, with a 3-second timeout per
                    attempt.
                  example: https://your-server.com/goenhance/callback
              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
            example:
              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
      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: {}

````