Image models
Qwen Image
Qwen Image — fast, high-fidelity AI image generation & editing.
| modelId | qwen-text-to-image, qwen-image-to-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | modelId | Endpoint | Required input |
|---|---|---|---|
| Text To Image | qwen-text-to-image | POST /api/v1/generate | prompt |
| Image To Image | qwen-image-to-image | POST /api/v1/generate | prompt, image_url |
| Poll task | — | GET /api/v1/task/{id}?model=qwen-text-to-image | — |
Text To Image — qwen-text-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The prompt to generate the image with Max 5000 characters. (default: A terraced rice field at dawn wrapped in fog, farmers walking the ridgeline, soft pastel light, wide landscape.) |
| image_size | string | No | The size of the generated image (options: square | square_hd | portrait_4_3 | portrait_16_9 | landscape_4_3 | landscape_16_9) (default: square_hd) |
| num_inference_steps | number | No | The number of inference steps to perform (range 2-250) (default: 30) |
| seed | number | No | The same seed and the same prompt given to the same version of the model will output the same image every time |
| guidance_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you (range 0-20) (default: 2.5) |
| enable_safety_checker | boolean | No | The safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (true/false) (default: true) |
| output_format | string | No | The format of the generated image (options: png | jpeg) (default: png) |
| negative_prompt | string | No | The negative prompt for the generation Max 500 characters. (default: ) |
| acceleration | string | No | 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 (options: none | regular | high) (default: none) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"qwen-text-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","image_size":"square_hd","num_inference_steps":30,"seed":1,"guidance_scale":2.5,"enable_safety_checker":true,"output_format":"png","negative_prompt":"blurry, low quality, distorted, watermark, text","acceleration":"none","nsfw_checker":true}}'Image To Image — qwen-image-to-image
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | string | Yes | The prompt to generate the image with Max 5000 characters. (default: Turn this plain teacup photo into a delicate watercolor still-life, softening the porcelain into loose washes of blue and letting the rising steam bleed gently into the paper grain.) |
| image_url | string | Yes | The reference image to guide the generation (image URL) |
| strength | number | No | Denoising strength. 1.0 = fully remake; 0.0 = preserve original (range 0-1) (default: 0.8) |
| output_format | string | No | The format of the generated image (options: png | jpeg) (default: png) |
| acceleration | string | No | 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 (options: none | regular | high) (default: none) |
| negative_prompt | string | No | The negative prompt for the generation Max 500 characters. (default: blurry, ugly) |
| seed | number | No | The same seed and the same prompt given to the same version of the model will output the same image every time |
| num_inference_steps | number | No | The number of inference steps to perform (range 2-250) (default: 30) |
| guidance_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you (range 0-20) (default: 2.5) |
| enable_safety_checker | boolean | No | The safety checker is always enabled in Playground. It can only be disabled by setting false through the API. (true/false) (default: true) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"qwen-image-to-image","input":{"prompt":"A photorealistic portrait of a red fox in a snowy forest, soft morning light, shallow depth of field, 85mm.","image_url":"https://example.com/input.jpg","strength":0.8,"output_format":"png","acceleration":"none","negative_prompt":"blurry, low quality, distorted, watermark, text","seed":1,"num_inference_steps":30,"guidance_scale":2.5,"enable_safety_checker":true,"nsfw_checker":true}}'