Browse ModelsAlibabaAlibaba Wan 2.7 Text To Image

Alibaba Wan 2.7 Text To Image

Alibaba Wan 2.7 Text To Image

Playground

Try it on WavespeedAI!

Alibaba WAN 2.7 Text-to-Image generates high-quality images from text prompts with thinking mode for enhanced image quality. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.

Features

Alibaba Wan 2.7 Text-to-Image

Alibaba Wan 2.7 Text-to-Image (alibaba/wan-2.7/text-to-image) is Alibaba’s latest text-to-image generation model with built-in thinking mode for enhanced reasoning and higher-quality outputs. It’s designed for creative and production workflows—concept art, product visuals, portraits, and stylized imagery—where you want strong prompt adherence, flexible sizing, and smarter composition powered by chain-of-thought reasoning.


Why it stands out

  • Thinking mode for smarter generation Built-in thinking mode enables the model to reason about prompt intent before generating, producing more coherent compositions and better prompt adherence.

  • Fast, one-shot text-to-image generation Generate an image in a single run for quick ideation and production workflows.

  • Custom size output Set output size directly (768–2048 per dimension) to match banners, thumbnails, posters, or social formats.

  • Seeded iteration Use a fixed seed to refine style and layout with more repeatable variations.


Parameters

ParameterDescription
prompt*Text description of the image you want to generate.
sizeOutput size in pixels (widthheight). Range: 768–2048 per dimension. Default: 10241024.
thinking_modeEnable thinking mode for enhanced reasoning and better image quality (default: true). Increases generation time.
seedSet a fixed seed for more repeatable iterations (-1 for random).

How to use

  1. Write a clear prompt (subject + setting + style).
  2. Choose a size that matches your target aspect ratio (e.g. 10241024, 10241536, 1536*1024).
  3. Leave thinking_mode enabled (default) for best quality, or disable it for faster generation.
  4. Set a seed if you want repeatable iterations (keep the same seed while you tweak the prompt).
  5. Click Run, review the result, and iterate.

Prompt tips

  • Start with subject + environment + style: “A modern tea shop interior, warm afternoon light, minimalist wood design, cinematic photography.”
  • Add camera / composition when framing matters: “wide shot, shallow depth of field, 35mm film look.”
  • Keep instructions positive and specific (what you want to see, not what you fear).
  • With thinking mode enabled, the model handles short or ambiguous prompts better—but detailed prompts still yield the best results.

Pricing

  • $0.03 per generated image

Notes

  • Output size is limited to 768–2048 pixels per dimension. If a size fails, reduce resolution or choose a more standard aspect ratio.
  • Thinking mode is enabled by default and improves quality, but adds some latency. Disable it if speed is the priority.
  • Returned image URLs may be time-limited—save outputs if you need long-term storage.

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/alibaba/wan-2.7/text-to-image" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "1024*1024",
    "thinking_mode": true,
    "seed": -1
}'

# 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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
sizestringNo1024*1024768 ~ 2048 per dimensionThe size of the generated image in pixels (width*height). Range: 768-2048 per dimension.
thinking_modebooleanNotrue-Enable thinking mode for enhanced reasoning and better image quality. Increases generation time.
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsobjectArray of URLs to the generated content.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.