Wan 2.1 Text To Image LoRA
Playground
Try it on WavespeedAI!Wan 2.1 Text-to-Image LoRA repurposes Wan 2.1 to create ultra-realistic images with exceptional detail and LoRA fine-tuning support. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Wan 2.1 Text-to-Image LoRA
Generate photorealistic images with custom style control using Wan 2.1 Text-to-Image LoRA. This versatile model supports both pure text-to-image generation and image-to-image transformation with adjustable strength — plus full LoRA support for unique visual styles.
Why It Looks Great
- Photorealistic output: Optimized for lifelike, natural imagery.
- LoRA support: Apply custom LoRA adapters for unique styles and characters.
- Image-to-image mode: Transform existing images with adjustable strength control.
- Custom dimensions: Precise control over width and height for any aspect ratio.
- Prompt Enhancer: Built-in tool to refine your descriptions automatically.
- Reproducible results: Use the seed parameter to recreate exact outputs.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the image you want to generate. |
| image | No | Optional source image for image-to-image transformation. |
| strength | No | How much to transform the source image (0.0-1.0). Default: 0.8. |
| loras | No | Custom LoRA adapters to apply for style control. |
| width | No | Output width in pixels (e.g., 1024). |
| height | No | Output height in pixels (e.g., 1024). |
| seed | No | Random seed for reproducibility. Use -1 for random. |
| output_format | No | File format: jpeg or png. Default: jpeg. |
How to Use
Text-to-Image
- Write your prompt — describe the image in detail.
- Use Prompt Enhancer (optional) — click to enrich your description.
- Add LoRAs (optional) — click ”+ Add Item” for custom styles.
- Set dimensions — adjust width and height as needed.
- Run — click the button to generate.
- Download — preview and save your image.
Image-to-Image
- Upload source image — the image to transform.
- Write your prompt — describe the desired transformation.
- Adjust strength — lower values preserve more of the original (0.3-0.5), higher values allow more change (0.7-1.0).
- Run — click the button to generate.
Pricing
Flat rate per image.
| Output | Cost |
|---|---|
| Per image | $0.025 |
Strength Guide (Image-to-Image)
| Strength | Effect | Best For |
|---|---|---|
| 0.3-0.4 | Subtle changes, preserves original | Minor style adjustments |
| 0.5-0.6 | Moderate transformation | Balanced edits |
| 0.7-0.8 | Significant changes | Style transfer, major edits |
| 0.9-1.0 | Near-complete transformation | Heavy stylization |
Best Use Cases
- Photorealistic Portraits — Generate lifelike portraits with natural lighting.
- Style Transfer — Transform images with custom LoRA styles.
- Lifestyle Photography — Create authentic everyday scenes.
- Character Consistency — Use character LoRAs for consistent identity.
- Custom Aesthetics — Apply trained LoRAs for unique visual styles.
Example Prompts
- “A young woman hanging laundry on a sunny balcony, soft shadows, fluttering clothes, warm afternoon light, urban neighborhood, photorealistic, 35mm lens”
- “Professional headshot, soft studio lighting, neutral background, sharp focus”
- “Cozy kitchen scene, morning light through window, steam rising from coffee”
- “Street photography, candid moment, natural expressions, urban environment”
- “Product shot on marble surface, dramatic lighting, clean composition”
How to Use LoRAs
For detailed guides on using and training custom LoRAs:
Pro Tips for Best Results
- Include camera/lens details for realistic style: “35mm lens”, “f/1.8”, “bokeh”.
- Describe lighting: “soft shadows”, “warm afternoon light”, “studio lighting”.
- Use image-to-image with lower strength (0.3-0.5) to preserve composition.
- LoRAs can dramatically change output style — experiment with different adapters.
- Square dimensions (1024×1024) work well for portraits; adjust for other compositions.
Notes
- Supports both text-to-image and image-to-image workflows.
- If using a URL for the source image, ensure it is publicly accessible.
- The strength parameter only applies when a source image is provided.
- LoRA effects are cumulative — start with one and add more as needed.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/wan-2.1/text-to-image-lora" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"strength": 0.6,
"loras": [],
"size": "1024*1024",
"seed": -1,
"output_format": "jpeg",
"enable_base64_output": false,
"enable_sync_mode": false
}'
# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"
Parameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| image | string | No | - | The image to generate an image from (optional). | |
| strength | number | No | 0.6 | 0.00 ~ 1.00 | Strength indicates extent to transform the reference image. |
| loras | array | No | max 3 items | List of LoRAs to apply (maximum 3). | |
| loras[].path | string | Yes | - | Path to the LoRA model | |
| loras[].scale | float | Yes | - | 0.0 ~ 4.0 | Scale of the LoRA model |
| size | string | No | 1024*1024 | 256 ~ 1536 per dimension | The size of the generated media in pixels (width*height). |
| seed | integer | No | -1 | -1 ~ 2147483647 | The random seed to use for the generation. -1 means a random seed will be used. |
| output_format | string | No | jpeg | jpeg, png, webp | The format of the output image. |
| enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API. |
| enable_sync_mode | boolean | No | false | - | If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Array of URLs to the generated content (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | Array of URLs to the generated content (empty when status is not completed). |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |