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

# Wan 2.2 Animate Mix - Character Replacement in Video

> [Core Function] Wan 2.2 Animate Mix - Character Replacement in Video is a legacy video editing and motion transfer model. [Strengths] Provided enhanced dynamic camera movements and rich lighting effects. Maintained for backward compatibility. [Best For] Existing legacy integrations and workflows that strictly depend on this specific model version's quirks. [Limitations] Do NOT use this for new creations. It is a legacy model maintained for backward compatibility. [Routing] Only use if explicitly requested; otherwise use Wan 2.7 Video Editing.



## OpenAPI

````yaml /model-api/alibaba/alibaba-v2v.json post /alibaba/wan2.2-animate-mix
openapi: 3.1.0
info:
  description: The video-to-video models API from Alibaba.
  version: 1.0.0
  contact:
    name: Modellix Support
    email: support@modellix.ai
  title: Alibaba Video-to-Video Models API
servers:
  - url: https://api.modellix.ai/api/v1
    description: The video-to-video models API from Alibaba.
security:
  - bearerAuth: []
paths:
  /alibaba/wan2.2-animate-mix:
    post:
      summary: Wan 2.2 Animate Mix - Character Replacement in Video
      description: >-
        [Core Function] Wan 2.2 Animate Mix - Character Replacement in Video is
        a legacy video editing and motion transfer model. [Strengths] Provided
        enhanced dynamic camera movements and rich lighting effects. Maintained
        for backward compatibility. [Best For] Existing legacy integrations and
        workflows that strictly depend on this specific model version's quirks.
        [Limitations] Do NOT use this for new creations. It is a legacy model
        maintained for backward compatibility. [Routing] Only use if explicitly
        requested; otherwise use Wan 2.7 Video Editing.
      operationId: wan22AnimateMixAsync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Wan22AnimateMixRequest'
            examples:
              standard_mode:
                summary: Standard mode - cost-effective character replacement
                value:
                  image_url: https://example.com/new_actor.jpg
                  video_url: https://example.com/original_scene.mp4
                  mode: wan-std
              professional_mode:
                summary: Professional mode - high-quality film production
                value:
                  image_url: https://example.com/lead_actor.jpg
                  video_url: https://example.com/scene_footage.mp4
                  mode: wan-pro
                  check_image: true
              quick_preview:
                summary: Quick preview - skip detection for faster results
                value:
                  image_url: https://example.com/character.jpg
                  video_url: https://example.com/scene.mp4
                  mode: wan-std
                  check_image: false
      responses:
        '200':
          description: Task submitted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AsyncTaskResponse'
components:
  schemas:
    Wan22AnimateMixRequest:
      type: object
      required:
        - image_url
        - video_url
        - mode
      properties:
        image_url:
          type: string
          format: uri
          description: >-
            Character image URL to replace the video protagonist (HTTP/HTTPS,
            publicly accessible, no Chinese or non-ASCII characters). Format:
            JPG/JPEG/PNG/BMP/WEBP. Size: width and height both in [200, 4096]
            pixels, aspect ratio 1:3 to 3:1. File size: ≤ 5MB. Content
            requirement: ensure the character in image has similar aspect ratio
            to the character in reference video for best results
          example: https://example.com/new_character.jpg
        video_url:
          type: string
          format: uri
          description: >-
            Reference video URL with the original character to be replaced
            (HTTP/HTTPS, publicly accessible, no Chinese or non-ASCII
            characters). Format: MP4/AVI/MOV. Duration: 2-30 seconds. Size:
            width and height both in [200, 2048] pixels, aspect ratio 1:3 to
            3:1. File size: ≤ 200MB. The model will replace the character in
            this video while preserving scene, lighting, and color tone. Tip:
            Higher resolution and frame rate improve output quality
          example: https://example.com/original_scene.mp4
        mode:
          type: string
          description: >-
            Model service mode. Options: (1) 'wan-std': Standard mode - faster
            generation, cost-effective, suitable for quick preview and basic
            character replacement; (2) 'wan-pro': Professional mode - higher
            animation smoothness and better quality, suitable for film
            post-production and final output
          enum:
            - wan-std
            - wan-pro
          example: wan-std
        check_image:
          type: boolean
          description: >-
            Whether to perform image quality detection. When true (default),
            validates input image quality and content. When false, skips
            detection for faster processing. Recommended to keep true for
            production use to ensure best results
          default: true
          example: true
    AsyncTaskResponse:
      type: object
      required:
        - code
        - message
        - data
      properties:
        code:
          type: integer
          description: Response code, 0 indicates success
          example: 0
        message:
          type: string
          description: Response message
          example: success
        data:
          type: object
          required:
            - status
            - task_id
            - model_id
          properties:
            status:
              type: string
              enum:
                - pending
                - processing
              description: Task status
              example: pending
            task_id:
              type: string
              description: Unique task identifier
              example: task-abc123
            model_id:
              type: string
              description: Model ID
              example: model-123
            get_result:
              type: object
              description: API information to query the task result
              properties:
                method:
                  type: string
                  description: HTTP method
                  example: GET
                url:
                  type: string
                  description: Full URL to query the task result
                  example: https://api.modellix.ai/api/v1/tasks/task-abc123
          description: Detailed data about the submitted asynchronous task.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.'

````