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
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
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
REQUEST_BODY=$(cat <<'JSON'
{
"prompt": "A cinematic ocean wave at sunrise, highly detailed",
"strength": 0.6,
"size": "1024*1024",
"seed": -1,
"output_format": "jpeg"
}
JSON
)
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/wan-2.1/text-to-image-lora" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}")
TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body \
"${RESULT_URL}" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}")
RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')
case "${STATUS}" in
completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
esac
doneParameters
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 ~ 1 | Strength indicates extent to transform the reference image. |
| loras | array<object> | No | 0 ~ 3 items | List of LoRAs to apply (max 3). | |
| size | string | No | 1024*1024 | - | The size of the generated media in pixels (width*height). |
| seed | integer | No | -1 | - | 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 set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN. |
| enable_sync_mode | boolean | No | false | - | If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models. |
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 | Output values, usually URL strings; some models return text strings or structured result objects (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 |
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 |
| data.model | string | Model ID used for the prediction |
| data.outputs | array<string | object> | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created |
| 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 |