Documentation Index Fetch the complete documentation index at: https://docs.oxen.ai/llms.txt
Use this file to discover all available pages before exploring further.
Try Qwen Image 2.0 Pro in the Workbench Run this model interactively, tune parameters, and compare outputs.
Model ID: qwen-image-2Qwen Image 2.0 Pro is the pro version of Qwen Image 2 from Alibaba’s Qwen team. Enhanced text rendering, realism, and semantic adherence for high-quality image generation and editing.It is a 7B-parameter architecture that generates images natively at up to 2048×2048 pixels (2K resolution) and supports prompts up to 1,000 tokens. The model excels in professional-grade typography for complex layouts including PPT slides, infographics, movie posters, calendars, data charts, and comics. Text adapts to surfaces like glass, fabric, and signage with correct perspective and supports both Chinese and English characters.
Metric Value Parameter Count 7 billion Mixture of Experts No Context Length 1,000 tokens Max Resolution 2048×2048 (2K) Multilingual Yes (Chinese, English) Quantized* Unknown
*Quantization is specific to the inference provider and the model may be offered with different quantization levels by other providers.
Example request Use the Workbench as a request builder: configure parameters for this model in the UI, then open the API tab to copy the exact cURL or Python call. Sync
Async
Async with SSE
See the image editing reference for more details. Minimal
Basic parameters
All parameters
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>" }'
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }'
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "match_input_image": false, "aspect_ratio": "1:1", "enable_prompt_expansion": true, "negative_prompt": "<negative_prompt>" }'
See the async queue reference for more details. Minimal
Basic parameters
All parameters
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>" }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "match_input_image": false, "aspect_ratio": "1:1", "enable_prompt_expansion": true, "negative_prompt": "<negative_prompt>" }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
See the async queue reference for more details. Minimal
Basic parameters
All parameters
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>" }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "qwen-image-2", "prompt": "<prompt>", "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "match_input_image": false, "aspect_ratio": "1:1", "enable_prompt_expansion": true, "negative_prompt": "<negative_prompt>" }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
Fetch model details The models endpoint returns the full model object, including its json_request_schema.
curl -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/ai/models/qwen-image-2
Request parameters Required parameters Field Type Default Description promptstring— Text prompt for image generation or editing
Optional parameters Field Type Default Description input_imagestring— Optional reference image for image editing, style transfer, or image-to-image generation Format: uri. match_input_imagebooleanfalseWhen true and an image is provided, use the input image’s aspect ratio and resolution instead of the aspect_ratio parameter aspect_ratiostring"1:1"Aspect ratio of the generated image One of: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2. enable_prompt_expansionbooleantrueAutomatically expand and optimize the prompt for better results negative_promptstring""Negative prompt to specify elements to avoid in the generated image seedinteger— Random seed for reproducible generation. Range: 0-2147483647
