Alibaba

llms.txt

Qwen Image

Name: Qwen Image
Brand: Alibaba
Price: 0.02 USD
Availability: InStock

AI Image Generation Model

Image

Alibaba's Qwen image model

Qwen Image API OpenAI-compatible

Integrate Qwen Image into your workflow via Lumenfall’s OpenAI-compatible API to generate high-quality images from text prompts with a single unified integration.

Base URL

https://api.lumenfall.ai/openai/v1

Model

qwen-image

Code Examples

Text to Image

/v1/images/generations

curl -X POST \

  https://api.lumenfall.ai/openai/v1/images/generations \

  -H "Authorization: Bearer $LUMENFALL_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{

    "model": "qwen-image",

    "prompt": "",

    "size": "1024x1024"

}'

# Response:

# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

import OpenAI from 'openai';

const client = new OpenAI({

  apiKey: 'YOUR_API_KEY',

  baseURL: 'https://api.lumenfall.ai/openai/v1'

});

const response = await client.images.generate({

  model: 'qwen-image',

  prompt: '',

  size: '1024x1024'

});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }

console.log(response.data[0].url);

from openai import OpenAI

client = OpenAI(

    api_key="YOUR_API_KEY",

    base_url="https://api.lumenfall.ai/openai/v1"

response = client.images.generate(

    model="qwen-image",

    prompt="",

    size="1024x1024"

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }

print(response.data[0].url)

Image Edit

/v1/images/edits

curl -X POST \

  https://api.lumenfall.ai/openai/v1/images/edits \

  -H "Authorization: Bearer $LUMENFALL_API_KEY" \

  -F "model=qwen-image" \

  -F "[email protected]" \

  -F "prompt=Add a starry night sky to this image" \

  -F "size=1024x1024"

# Response:

# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

import OpenAI from 'openai';

import fs from 'fs';

const client = new OpenAI({

  apiKey: 'YOUR_API_KEY',

  baseURL: 'https://api.lumenfall.ai/openai/v1'

});

const response = await client.images.edit({

  model: 'qwen-image',

  image: fs.createReadStream('source.png'),

  prompt: 'Add a starry night sky to this image',

  size: '1024x1024'

});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }

console.log(response.data[0].url);

from openai import OpenAI

client = OpenAI(

    api_key="YOUR_API_KEY",

    base_url="https://api.lumenfall.ai/openai/v1"

response = client.images.edit(

    model="qwen-image",

    image=open("source.png", "rb"),

    prompt="Add a starry night sky to this image",

    size="1024x1024"

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }

print(response.data[0].url)

Parameter Reference

Required Supported Not available

Core Parameters

Parameter	Type	Description	Modes
`prompt`	string	Required. Text prompt for image generation	T2I Edit
`negative_prompt`	string	Negative prompt to guide generation away from undesired content	T2I Edit
`seed`	integer	Random seed for reproducibility	T2I Edit

Size & Layout

Parameter	Type	Description	Modes
`size`	string	Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9") `1365x768` `768x1365` `1254x836` `836x1254` `887x1182` `1024x1024` `1183x887` WxH determines both shape and scale (aspect_ratio and resolution are ignored when size is provided). W:H format is equivalent to aspect_ratio.	T2I Edit
`aspect_ratio`	string	Aspect ratio of the output image (e.g. "16:9", "1:1") `9:16` `2:3` `3:4` `1:1` `4:3` `3:2` `16:9` Controls shape independently of scale. Use with resolution to control both. If size is also provided, size takes precedence. Any ratio is accepted and mapped to the nearest supported value.	T2I Edit
`resolution`	string	Output resolution tier (e.g. "1K", "4K") `1K` Controls scale independently of shape. Higher tiers produce larger images and cost more. If size is also provided, size takes precedence for scale. Any tier is accepted and mapped to the nearest supported value.	T2I Edit

Output	`size`		`aspect_ratio` + `resolution`
Flexible
Custom 1–14142px per side	`"WxH"`	—	Any pixel dimensions within model constraints

1K 7 sizes

Output	`size`		`aspect_ratio` + `resolution`
1183 × 887	`"1183x887"`	or	`"4:3"` + `"1K"`
1024 × 1024	`"1024x1024"`	or	`"1:1"` + `"1K"`
887 × 1182	`"887x1182"`	or	`"3:4"` + `"1K"`
836 × 1254	`"836x1254"`	or	`"2:3"` + `"1K"`
1254 × 836	`"1254x836"`	or	`"3:2"` + `"1K"`
768 × 1365	`"768x1365"`	or	`"9:16"` + `"1K"`
1365 × 768	`"1365x768"`	or	`"16:9"` + `"1K"`

How these parameters work

size

Exact pixel dimensions

"1920x1080"

aspect_ratio

Shape only, default scale

"16:9"

resolution

Scale tier, preserves shape

"1K"

Priority when combined

size › aspect_ratio + resolution › aspect_ratio › resolution

size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.

How matching works

Shape matching – we pick the closest supported ratio. Ask for 7:1 on a model with 4:1 and 8:1, you get 8:1.

Scale matching – providers use different tier formats: K tiers (0.5K 1K 2K 4K) or megapixel tiers (0.25 1). If the exact tier isn't available, you get the nearest one.

Dimension clamping – if a model has pixel limits, we clamp dimensions to fit and keep the aspect ratio intact.

Media Inputs

Parameter	Type	Description	Modes
`image`	file	Required. Input image(s) to edit Supports PNG, JPEG, WebP.	T2I Edit

Output & Format

Parameter	Type	Description	Modes
`response_format`	string	How to return the image `url` `b64_json` Default: `"url"`	T2I Edit
`output_format`	string	Output image format `png` `jpeg` `gif` `webp` `avif` Gateway converts to requested format if provider doesn't support it natively.	T2I Edit
`output_compression`	integer	Compression level for lossy formats (JPEG, WebP, AVIF)	T2I Edit
`n`	integer	Number of images to generate Default: `1` Gateway generates multiple images in parallel even if provider only supports 1.	T2I Edit

Additional Parameters

Parameter	Type	Description	Modes
`cfg_scale`	number	Classifier-free guidance scale — higher values stick more closely to the prompt	T2I Edit
`strength`	number	How much to transform the input image: 0 keeps it unchanged, 1 fully regenerates from the prompt	T2I Edit
`acceleration` fal	string	Acceleration level for image generation. Options: 'none', 'regular', 'high'. Higher acceleration increases speed. 'regular' balances speed and quality. 'high' is recommended for images without text. `high` `none` `regular`	T2I Edit
`disable_safety_checker` replicate	boolean	Disable safety checker for generated images.	T2I Edit
`enable_safety_checker` fal	boolean	If set to true, the safety checker will be enabled.	T2I Edit
`enhance_prompt` replicate	boolean	Enhance the prompt with positive magic.	T2I Edit
`extra_lora_scale` replicate	array	Scales for additional LoRAs as an array of numbers (e.g., 0.5, 0.7). Must match the number of weights in extra_lora_weights.	T2I Edit
`extra_lora_weights` replicate	array	Additional LoRA weights as an array of URLs. Same formats supported as lora_weights (e.g., ['https://huggingface.co/flymy-ai/qwen-image-lora/resolve/main/pytorch_lora_weights.safetensors', 'https://huggingface.co/flymy-ai/qwen-image-realism-lora/resolve/main/flymy_realism.safetensors'])	T2I Edit
`go_fast` replicate	boolean	Run faster predictions with additional optimizations.	T2I Edit
`image_size` replicate	string	Image size for the generated image `optimize_for_quality` `optimize_for_speed`	T2I Edit
`lora_scale` replicate	number	Determines how strongly the main LoRA should be applied.	T2I Edit
`lora_weights` replicate	string	Load LoRA weights. Only works with text to image pipeline. Supports arbitrary .safetensors URLs, tar files, and zip files from the Internet (for example, 'https://huggingface.co/flymy-ai/qwen-image-lora/resolve/main/pytorch_lora_weights.safetensors', 'https://example.com/lora_weights.tar.gz', or 'https://example.com/lora_weights.zip')	T2I Edit
`loras` fal	array	The LoRAs to use for the image generation. You can use up to 3 LoRAs and they will be merged together to generate the final image.	T2I Edit
`num_inference_steps`	integer	The number of inference steps to perform.	T2I Edit
`output_quality` replicate	integer	Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs	T2I Edit
`replicate_weights` replicate	string	Load LoRA weights from Replicate training. Only works with text to image pipeline. Supports arbitrary .safetensors URLs, tar files, and zip files from the Internet.	T2I Edit
`sync_mode` fal	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	T2I Edit
`use_turbo` fal	boolean	Enable turbo mode for faster generation with high quality. When enabled, uses optimized settings (10 steps, CFG=1.2).	T2I Edit

Parameter Normalization

How we handle parameters across different providers

Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:

Behavior	What happens	Example
`passthrough`	Sent as-is to the provider	style, quality
`renamed`	Same value, mapped to the field name the provider expects	prompt
`converted`	Transformed to the provider's native format	size
`emulated`	Works even if the provider has no concept of it	n, response_format

Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.

Full API Reference Authentication, endpoints, and more