> ## 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.

# AI Mermaid Spell Video Generator API

> Integrate AI-powered mermaid videos into your apps. Transform static images into magical underwater scenes with tail transformations.

## Example

Example output from the AI Mermaid Spell Video Generator API:

<video width="100%" controls>
  <source src="https://cdn.goenhance.ai/video/static/effects/e21646f1-ba22-474f-92d7-70346a011b99.mp4" type="video/mp4" />

  Your browser does not support the video tag.
</video>

## API Overview

The AI Mermaid Spell Video Generator API enables developers to programmatically create videos of subjects transforming into mermaids. By sending image data to our endpoint, your application can generate magical transformation sequences with realistic tail morphing, underwater effects, and oceanic environments. This API is perfect for integrating into fantasy applications, children's entertainment platforms, storytelling tools, or any service that would benefit from engaging, enchanting underwater transformation content.


## OpenAPI

````yaml POST /api/v2/videoeffect/generate/mermaid_spell
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/v2/videoeffect/generate/mermaid_spell:
    post:
      tags: []
      summary: AI Mermaid Spell Generator API
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: true
          example: '{{Authorization}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                args:
                  type: object
                  properties:
                    reference_img:
                      type: string
                      description: target image, Max 5M
                  x-apifox-orders:
                    - effect_id
                    - model
                    - reference_img
                    - is_private
              required:
                - args
              x-apifox-orders:
                - args
                - type
            example:
              args:
                reference_img: >-
                  https://cdn.goenhance.ai/user/goenhance/f52840534004f9a52cbe6d2aec7fa164.jpg
      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: {}
      deprecated: false
      security: []
components: {}

````