Qwen Image Generator API documentation
Generate images with Qwen Image Generator (Alibaba Qwen). Supports both text and image input modes.
Endpoints
| Contract item | Value |
|---|---|
| Capability | qwen-image-generator |
| Submit | POST https://vidmage.ai/api/v1/qwen-image-generator/submit |
| Query | POST https://vidmage.ai/api/v1/qwen-image-generator/query |
| Task identifier | taskId |
| Result field | imageUrl |
Authenticate with Authorization: Bearer YOUR_API_KEY. Save the task identifier and query the same capability. Use a stable Idempotency-Key for submission retries.
Product guide: Qwen Image API
Parameters and input rules
| Field | Type | Required | Default | Meaning and limits |
|---|---|---|---|---|
prompt | string | Yes | Not specified | Text prompt describing the image to generate (max 800 chars). For an unspecified character or figurine, use an original non-branded character with no logos and no resemblance to existing copyrighted superheroes; preserve any character the user explicitly names. Minimum characters: 1Maximum characters: 800 |
imageUrl | string | No | Not specified | Optional input image URL. When provided, the task runs in image edit mode. |
imageUrls | string[] | No | Not specified | Ordered input image URLs for image editing mode. The prompt can reference them by their one-based order. Minimum items: 1Maximum items: 3 |
negativePrompt | string | No | Not specified | Describe content that should not appear in the image. Maximum characters: 500 |
size | string | No | "1024*1024" | Exact output dimensions. Values: "1024*1024", "1536*1536", "768*1152", "1024*1536", "1152*768", "1536*1024", "960*1280", "1080*1440", "1280*960", "1440*1080", "720*1280", "1080*1920", "1280*720", "1920*1080", "1344*576", "2048*872" |
imageNum | string | No | "1" | Number of images to generate. Values: "1", "2", "3", "4", "5", "6" |
promptExtend | boolean | No | true | Enhance and enrich the prompt automatically. |
text to image
These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.
| Control | Mode-specific rule |
|---|---|
prompt | Required; 1–800 characters. |
aspectRatio | Not used in this mode. |
resolution | Not used in this mode. |
negativePrompt | Describe content that should not appear in the image. Maximum characters: 500 |
size | Exact output dimensions. Values: "1024*1024", "1536*1536", "768*1152", "1024*1536", "1152*768", "1536*1024", "960*1280", "1080*1440", "1280*960", "1440*1080", "720*1280", "1080*1920", "1280*720", "1920*1080", "1344*576", "2048*872"Default: "1024*1024" |
imageNum | Number of images to generate. Values: "1", "2", "3", "4", "5", "6"Default: "1" |
promptExtend | Enhance and enrich the prompt automatically. Default: true |
image edit
These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.
| Control | Mode-specific rule |
|---|---|
prompt | Required; 1–800 characters. |
aspectRatio | Not used in this mode. |
resolution | Not used in this mode. |
imageUrls | Up to 3 files. Maximum 10 MB per file. Formats: jpg, jpeg, png, bmp, tiff, webp, gif. |
negativePrompt | Describe content that should not appear in the edited image. Maximum characters: 500 |
size | Exact output dimensions. Values: "1024*1024", "1536*1536", "768*1152", "1024*1536", "1152*768", "1536*1024", "960*1280", "1080*1440", "1280*960", "1440*1080", "720*1280", "1080*1920", "1280*720", "1920*1080", "1344*576", "2048*872" |
imageNum | Number of images to generate. Values: "1", "2", "3", "4", "5", "6"Default: "1" |
Example request
{
"prompt": "An isometric sustainable neighborhood with rooftop gardens, bicycle paths, and solar panels",
"size": "1024*1024",
"imageNum": "1",
"promptExtend": true
}# Set VIDMAGE_IDEMPOTENCY_KEY to a unique value for this task; preserve it for transport retries.
curl -X POST "https://vidmage.ai/api/v1/qwen-image-generator/submit" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: ${VIDMAGE_IDEMPOTENCY_KEY}" \
-H "Content-Type: application/json" \
-d '{"prompt":"An isometric sustainable neighborhood with rooftop gardens, bicycle paths, and solar panels","size":"1024*1024","imageNum":"1","promptExtend":true}'
# -> { "success": true, "taskId": "...", "creditsConsumed": ... }Task results and recovery
URL of the generated image. Read imageUrl from the completed query response. Preserve taskId while the task is running.
curl -X POST "https://vidmage.ai/api/v1/qwen-image-generator/query" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "taskId": "TASK_ID_FROM_SUBMIT" }'
# -> { "success": true, "data": { "status": "...", "imageUrl": "https://..." } }Submission and task queries report the available task and usage information. A timeout is not a confirmed failure. Recover the existing task instead of resubmitting.
For face selection and error recovery, follow Task lifecycle. MCP uses the normalized taskId argument in get_task_result, including capabilities whose REST identifier is requestId.
Credits
| Component / option | Rate | Minimum |
|---|---|---|
| Base rate | 5 credits / generation | — |
Base charge is per generation at the selected resolution.
imageNum multiplies the base charge by the selected output count.
Use the Playground or the MCP credit estimator for your exact inputs. Credits and billing.