Turan for Dify

Turn product images into model styling, campaign visuals, patterns and videos directly in your Dify workflows.

Turan v0.1.0 includes 29 creative tools across five categories, plus a tool for recovering existing task results. Configure your Turan API Key once to use all available tools.

Source repository · Simplified Chinese guide · Privacy policy

Publisher: · Plugin ID: · Version:

Creative tools

Install and connect

1. Open Plugins in Dify and choose Install from local package.
2. Select and complete installation.
3. Sign in to Turan, or register an account if needed.
4. Open API Key management, create a key and copy it.
5. Open the Turan plugin's authorization settings in Dify, enter your API Key and save.

Your Turan account needs sufficient credits. Local-package installation is subject to your Dify administrator's plugin policy. If installation is blocked by signature verification, contact the administrator.

Connection requirements

The Dify plugin runtime needs access to:

• Your Dify file service, to read the files selected in the workflow. For self-hosted Dify, the administrator must configure file-service URLs reachable from the plugin runtime.
• and , for account authorization, tool configuration, image uploads and generation tasks.
• , for result files returned by Turan. Results hosted on the two Turan domains are also supported.

The API Key is sent only to the approved Turan API and upload endpoints. Result downloads do not include it. The plugin accepts Dify file inputs rather than arbitrary image URL parameters.

Build a workflow

1. Add a file input to your workflow's Start node for the source image.
2. Add a Turan tool and bind its image inputs to the relevant file variables.
3. Set the creative instructions, output specification and other business parameters.
4. Connect the tool's output to the next node or the workflow's Output node.
5. Run the workflow. The tool waits for generation and returns the resulting files when ready.

Image inputs support PNG, JPEG and WebP, up to 20 MiB each.

Reference images use one multi-image upload input. Upload just the images you need; each tool shows its maximum count. Their list order follows the corresponding image positions on Turan.

Aspect ratio and specification are text parameters that accept literal values or upstream variables. Each parameter name shows its default; its help text lists that tool's allowed values and reference specification prices. Use the exact values shown; available values vary by tool and are validated before submission. Keep API values as shown even when an option uses a Chinese value.

Tools return generated images or video through , together with , , and when available.

Credits and pricing

Usage is billed to the Turan account associated with your API Key. The plugin has no separate credit balance. Available specifications and reference costs appear in each tool; final pricing is confirmed by Turan at submission.

Recover a task result

If a workflow is interrupted or does not receive its files, keep the original task ID. Add Recover existing task result, enter that ID and use its output. Recovery retrieves the existing task without starting another generation. It does not automatically resume an already failed workflow.

Each tool invocation waits up to eight minutes. Your Dify workflow or network may have additional execution limits. Disable automatic retries on generation nodes to avoid creating another task when an earlier submission is uncertain.

Privacy

The plugin sends the images and parameters you select to Turan to perform the requested generation. Images and instructions may contain personal information. Review the plugin privacy policy and Turan service privacy policy before submitting them. On the Turan page, select Privacy Policy to open the policy; it is displayed in a dialog.

The plugin keeps only the latest task-recovery record per credential namespace in Dify storage. Retention of files, workflow records and Turan service data is explained in the privacy policy.

Support

Report bugs and request features through GitHub Issues. Do not include API keys or personal images in public reports.

Contact: [email protected].

Build and test

Python 3.12 is required. Install runtime and test dependencies, then run the offline test suite:

To build an installable package with the Dify plugin CLI, run this from the parent directory:

The package contains the plugin runtime and documentation. Tests and development scripts are excluded by .