New: add a new plugin hailuo_aigc-0.0.1.difypkg【Hailuo AIGC: Supports full pipeline operations for image and video generation, editing, etc., powered by the latest MiniMax models (MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-fast, MiniMax-Hailuo-02, T2V-01-Director, and image-01).】

[sawyer-shi]

Hailuo AIGC

A powerful Dify plugin providing comprehensive AI-powered image and video generation capabilities using MiniMax Hailuo models. Supports text-to-image, image-to-image with subject reference, text-to-video, image-to-video, first-last frame video, subject reference video, and video result query with optional download.

Version Information

• Current Version: v0.0.1
• Release Date: 2026-02-22
• Compatibility: Dify Plugin Framework
• Python Version: 3.12

Version History

• v0.0.1 (2026-02-22): Initial release with image and video generation capabilities

Quick Start

1. Install the plugin in your Dify environment
2. Configure your MiniMax API credentials (API Key)
3. Start generating images and videos with AI

Key Features

• Multiple Generation Modes: Text-to-image, image-to-image, text-to-video, image-to-video, first-last frame video, subject reference video
• Latest AI Models: Supports MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, T2V-01-Director, I2V-01-Director, I2V-01-live, I2V-01, S2V-01, image-01, image-01-live
• Flexible Image Ratios: Multiple aspect ratios from 1:1 to 21:9
• Video Generation: Task-based asynchronous generation with status query and download
• First-Last Frame Video: Create videos from first and last frame images
• Subject Reference Video: Create videos using subject reference images
• Watermark Control: Optional AIGC watermark for content authenticity

Core Features

Image Generation

Text to Image (text_2_image)

Generate images from text descriptions using MiniMax image models.

• Supported Models: image-01, image-01-live
• Features:
  • Multiple aspect ratios (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9)
  • Optional watermark
  • Optional prompt optimizer
  • Style options for image-01-live

Image to Image (image_2_image)

Generate images from text and a subject reference image.

• Supported Models: image-01, image-01-live
• Features:
  • Subject reference guidance (character)
  • Multiple aspect ratios
  • Optional watermark
  • Reference image (jpeg/png/webp; max 10MB)

Video Generation

Text to Video (text_2_video)

Create a video generation task from text.

• Supported Models: MiniMax-Hailuo-2.3, MiniMax-Hailuo-02, T2V-01-Director, T2V-01
• Features:
  • Task-based async generation
  • Resolution: 720P, 768P, 1080P
  • Optional prompt optimizer and fast pretreatment

Image to Video (image_2_video)

Create a video generation task from a single image.

• Supported Models: MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live, I2V-01
• Features:
  • Single image input as first frame
  • Resolution: 512P, 720P, 768P, 1080P
  • Optional prompt optimizer and fast pretreatment

First-Last Frame Video (images_2_video)

Create a video generation task from first and last frame images.

• Supported Models: MiniMax-Hailuo-02
• Features:
  • First and last frame inputs
  • Resolution: 768P, 1080P

Subject Reference Video (subject_reference_2_video)

Create a video generation task using a subject reference image.

• Supported Models: S2V-01
• Features:
  • Subject reference guidance (character)
  • Single reference image input

Video Result Query (video_query)

Query video generation task status and optionally download the video.

• Features:
  • Real-time task status
  • Download URL retrieval
  • Optional file download when status is Success

Requirements

• Python 3.12
• Dify Platform access
• MiniMax API credentials (API Key)
• Required Python packages (installed via requirements.txt):
  • dify_plugin>=0.2.0
  • requests>=2.31.0,<3.0.0
  • pillow>=10.0.0,<11.0.0

Installation & Configuration

1. Install the required dependencies:

   pip install -r requirements.txt

2. Configure your MiniMax API credentials in the plugin settings:

   • API Key: Your MiniMax API key
   • Get API key: https://platform.minimaxi.com/user-center/basic-information/interface-key

3. Install the plugin in your Dify environment

Usage

Image Generation Tools

1. Text to Image

• Parameters:
  • prompt: Text description of the image (required)
  • model: image-01 / image-01-live
  • aspect_ratio: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
  • response_format: url / base64
  • n: 1-9
  • prompt_optimizer: true / false
  • aigc_watermark: true / false
  • style_type / style_weight (image-01-live only)

2. Image to Image

• Parameters:
  • prompt: Text description (required)
  • subject_image: Subject reference image (required)
  • model: image-01 / image-01-live
  • aspect_ratio: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
  • response_format: url / base64
  • n: 1-9
  • prompt_optimizer: true / false
  • aigc_watermark: true / false

Video Generation Tools

3. Text to Video

• Parameters:
  • prompt: Text description (required)
  • model: MiniMax-Hailuo-2.3 / MiniMax-Hailuo-02 / T2V-01-Director / T2V-01
  • resolution: 720P / 768P / 1080P
  • duration: 6 or 10 (depends on model/resolution)
  • prompt_optimizer: true / false
  • fast_pretreatment: true / false (Hailuo 2.3/02 only)
  • aigc_watermark: true / false

4. Image to Video

• Parameters:
  • first_frame_image: Input image (required)
  • prompt: Optional text description
  • model: MiniMax-Hailuo-2.3 / MiniMax-Hailuo-2.3-Fast / MiniMax-Hailuo-02 / I2V-01-Director / I2V-01-live / I2V-01
  • resolution: 512P / 720P / 768P / 1080P
  • duration: 6 or 10 (depends on model/resolution)
  • prompt_optimizer: true / false
  • fast_pretreatment: true / false (Hailuo 2.3/02 only)
  • aigc_watermark: true / false

5. First-Last Frame Video

• Parameters:
  • first_frame_image: First frame image (required)
  • last_frame_image: Last frame image (required)
  • prompt: Optional text description
  • model: MiniMax-Hailuo-02
  • resolution: 768P / 1080P
  • duration: 6 or 10 (depends on resolution)
  • prompt_optimizer: true / false
  • aigc_watermark: true / false

6. Subject Reference Video

• Parameters:
  • subject_image: Subject reference image (required)
  • prompt: Optional text description
  • model: S2V-01
  • prompt_optimizer: true / false
  • aigc_watermark: true / false

7. Video Result Query

• Parameters:
  • task_id: Video generation task ID (required)
  • download_video: Download video file when available (default: true)

Notes

• Video generation is asynchronous; use Video Result Query to check status and retrieve results
• First/last frame video uses MiniMax-Hailuo-02 only
• Subject reference video currently supports a single subject image
• Reference images should be under 10MB (image) or 20MB (video) in size

Developer Information

• Author: https://github.com/sawyer-shi
• Email: sawyer36@foxmail.com
• License: Apache License 2.0
• Source Code: https://github.com/sawyer-shi/dify-plugins-hailuo_aigc
• Support: Through Dify platform and GitHub Issues

License Notice

This project is licensed under Apache License 2.0. See LICENSE file for full license text.

---

Ready to create stunning images and videos with AI?

Plugin Submission Form

1. Metadata

• Plugin Author:
• Plugin Name:
• Repository URL:

2. Submission Type

• New plugin submission
• Version update for existing plugin

3. Description

4. Checklist

• I have read and followed the Publish to Dify Marketplace guidelines
• I have read and comply with the Plugin Developer Agreement
• I confirm my plugin works properly on both Dify Community Edition and Cloud Version
• I confirm my plugin has been thoroughly tested for completeness and functionality
• My plugin brings new value to Dify

5. Documentation Checklist

Please confirm that your plugin README includes all necessary information:

• Step-by-step setup instructions
• Detailed usage instructions
• All required APIs and credentials are clearly listed
• Connection requirements and configuration details
• Link to the repository for the plugin source code

6. Privacy Protection Information

Based on Dify Plugin Privacy Protection Guidelines:

Data Collection

Privacy Policy

• I confirm that I have prepared and included a privacy policy in my plugin package based on the Plugin Privacy Protection Guidelines

[crazywoola]

PR Review Results

Check	Status	Required Action
Single .difypkg	✅ Pass	-
PR language (no CJK)	✅ Pass	-
Project structure	✅ Pass	-
Manifest author	✅ Pass	-
Icon valid	❌ Fail	Error checking icon: 'utf-8' codec can't decode byte 0x89 in position 0: invalid start byte
Version not exists	✅ Pass	-
README language (no Chinese)	✅ Pass	-
PRIVACY.md exists	✅ Pass	-
Dependencies install	✅ Pass	-
dify_plugin >= 0.5.0	❌ Fail	dify_plugin version 0.2.0 is too old (need >= 0.5.0)
Install test	❌ Fail	Install test failed: Testing plugin in directory: /var/folders/c5/ssq8b54n0rj6rbmghy7_2xdm0000gn/T/tmp6226tiow/repo/unpacked_plugin
{"version":"0.0.1","type":"plugin","author":"sawyer-shi","name":"hailuo_aigc","repo":"https://github.com/sawyer-shi/dify-plugins-hailuo_aigc","description":{"zh_Hans":"海螺AIGC：支持全套图片+视频的生成、编辑等操作，使用最新的MiniMax模型(MiniMax-Hailuo-2.3、MiniMax-Hailuo-2.3-fast以及MiniMax-Hailuo-02、T2V-01-Director 和 image-01)。","pt_BR":"Hailuo AIGC: Supports full pipeline operations for image and video generation, editing, etc., powered by the latest MiniMax models (MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-fast, MiniMax-Hailuo-02, T2V-01-Director, and image-01).","ja_JP":"Hailuo AIGC: Supports full pipeline operations for image and video generation, editing, etc., powered by the latest MiniMax models (MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-fast, MiniMax-Hailuo-02, T2V-01-Director, and image-01).","en_US":"Hailuo AIGC: Supports full pipeline operations for image and video generation, editing, etc., powered by the latest MiniMax models (MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-fast, MiniMax-Hailuo-02, T2V-01-Director, and image-01)."},"icon":"icon.png","icon_dark":null,"label":{"zh_Hans":"海螺AIGC","pt_BR":"Hailuo AIGC","ja_JP":"Hailuo AIGC","en_US":"Hailuo AIGC"},"created_at":"2026-02-21T16:57:01.384814+08:00","resource":{"memory":268435456,"permission":{"tool":{"enabled":true},"model":{"enabled":true,"llm":false,"text_embedding":false,"rerank":false,"tts":false,"speech2text":false,"moderation":false},"node":null,"endpoint":{"enabled":true},"app":{"enabled":true},"storage":{"enabled":true,"size":1048576}}},"plugins":{"tools":["provider/hailuo_aigc.yaml"],"models":[],"endpoints":[],"agent_strategies":[],"datasources":[],"triggers":[]},"meta":{"version":"0.0.1","arch":["amd64","arm64"],"runner":{"language":"python","version":"3.12","entrypoint":"main"},"minimum_dify_version":null}}

{"event": "log", "data": {"level": "INFO", "message": "Installed tool: hailuo_aigc", "timestamp": 1771898026.537029}}
{"event":"heartbeat","session_id":null,"data":{}}

{"event":"heartbeat","session_id":null,"data":{}}

!!! Force exit after 20 seconds
!!! Plugin test result: failed
!!! Process exited, here is the stderr:

================================================
!!! Have you tested it locally?
|
| Packaging test | ✅ Pass | - |

Next steps

Please address the failed checks above.

[crazywoola]

Re-review (concise)

Re-reviewed with concise notes (raw logs removed from the review body).

Check	Status	Required action
dify_plugin >= 0.5.0	❌ Fail	Update the plugin dependency to dify_plugin>=0.5.0.
Install verification	❌ Fail	Install validation did not pass in reviewer pre-check. Please use CI logs to identify and fix the root cause.
Packaging test	✅ Pass	No action needed.

Next steps

1. Bump dify_plugin to >=0.5.0.
2. Re-run CI and confirm install verification passes.
3. Push updates and request re-review.