alibaba/qwen-image-3/text-to-image

Name: Qwen Image 3 Text to Image
Author: Alibaba

Qwen Image 3 by Alibaba - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

Input

Prompt(string)

Text prompt describing the desired image. Supports Chinese and English. Max 5000 characters.

Output Format(string)

The format of the generated image. Allowed values: jpeg, png.

Seed(integer)

Random seed for reproducibility (0-2147483647).

Num Images(integer)

Range: 1 to 6.

Resolution(string)

Output resolution tier used by fal billing. Allowed values: 1K, 2K.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDalibaba/qwen-image-3/text-to-image

Input Schema

5 parameters · 1 required · 4 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Text prompt describing the desired image. Supports Chinese and English. Max 5000 characters. · Min length: 1 · Max length: 5000
`seed`	integer	Optional	Random seed for reproducibility (0-2147483647).
`num_images`	integer	Optional	Min: 1 · Max: 6 · Default: 1
`resolution`	string	Optional	Output resolution tier used by fal billing. · Options: 1K, 2K · Default: "1K" 1K2K
`output_format`	string	Optional	The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "alibaba/qwen-image-3/text-to-image",
  "prompt": "A cute baby koala holding a card that says \"Qwen Image 3 is now available on fal\" while on a water slide",
  "num_images": 1,
  "resolution": "1K",
  "output_format": "png"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Qwen Image 3 Text to Image

API README

PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: alibaba/qwen-image-3/text-to-image original_unit: Your request will cost $0.04 per generated image at 1K resolution, and $0.075 per generated image at 2K resolution. method: per-generated-image 1K/2K tiers; restored resolution and image count result_base_price: 0.04 result_price_formula: (params.num_images ?? 1) * ((params.resolution ?? "1K") == "2K" ? 0.075 : 0.04) review_status: pending; model remains disabled checked_at: 2026-08-16