Qwen Image API
Qwen Image API access for high-quality image generation, prompt-guided remixing, and precise text-driven editing.
curl -X POST https://runapi.ai/api/v1/qwen_image/edit_image \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen-image-text-to-image",
"image_url": "https://cdn.runapi.ai/public/samples/image.jpg",
"prompt": "Create a cinematic travel poster for Hangzhou at dusk, with clear bilingual title text reflected across the lake."
}'import { QwenImageClient } from "@runapi.ai/qwen-image";
const client = new QwenImageClient();
const result = await client.editImage.run({
model: "qwen-image-text-to-image",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Create a cinematic travel poster for Hangzhou at dusk, with clear bilingual title text reflected across the lake.",
});require "runapi/qwen_image"
client = RunApi::QwenImage::Client.new
result = client.edit_image.run(
model: "qwen-image-text-to-image",
image_url: "https://cdn.runapi.ai/public/samples/image.jpg",
prompt: "Create a cinematic travel poster for Hangzhou at dusk, with clear bilingual title text reflected across the lake."
)npx skills add runapi-ai/qwen-image -g# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursorQwen Image is Alibaba's visual generation family for creating new images, remixing source images, and applying precise edits from natural-language instructions. It combines strong language-to-visual alignment with reliable text rendering and semantic image editing.
- Multiple variants for different speed, quality, and cost tiers
- Model skill includes docs, schemas, pricing, and setup notes
- Works with Claude Code, Codex, Gemini CLI, Cursor, and VS Code
- Single API key and unified billing across all variants
- Async task management with polling and webhook callbacks
- Failed generations are not charged
Compare all API variants
Install the Qwen Image skill for app development
Load the model docs, schemas, pricing notes, and setup steps into your coding workspace.
# Install the model skill for app development workflows
npx skills add runapi-ai/qwen-image -gInstall the Qwen Image skill for this app: 1. Add runapi-ai/qwen-image with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
From model skill to first result in four steps
Choose a model
Browse the model catalog and pick the model and variant that match your output type, quality bar, and latency target. Each variant page shows its model ID, pricing, and parameter constraints so you can compare before committing.
Configure
Set your RunAPI API key as an environment variable and install the model skill in your coding workspace. The skill loads docs, typed schemas, pricing notes, and setup steps so your agent has the right context from the start.
Call
Use the skill instructions to add the model feature inside your application. Send a POST request with your prompt, model ID, and parameters. RunAPI routes the request, manages the async lifecycle, and returns structured JSON.
Receive
Poll by task ID for completion, stream results end-to-end when supported, or configure a webhook callback URL to receive results automatically. The CLI provides a built-in wait command, and the SDKs offer both polling and callback patterns.
What is the Qwen Image API?
Qwen Image is the original Alibaba image model line, distinct from the newer Qwen 2 generation. Through RunAPI, its generation, remix, and edit endpoints use separate model IDs and a consistent task contract.
Why route the Qwen Image API through RunAPI
One auth, every provider
A single RunAPI API key unlocks the whole model catalog across all providers. No separate accounts to create, no API keys to rotate per integration, and no credential management overhead. Add a new model to your app by changing one parameter.
Unified pricing & billing
Per-call pricing in USD, billed monthly into a single invoice. No subscription tiers, no minimum spend, and failed generations are never charged. The pricing page and check_pricing API show exact costs before you commit to a model.
Schema-first SDK
Typed schemas, parameter constraints, and setup notes are packaged in the model skill so your implementation starts from the right contract. The skill loads into Claude Code, Codex, Gemini CLI, Cursor, and VS Code — your agent knows the correct request shape before you write a line of code.
Common questions
What can I do with Qwen Image?
Create an image from a prompt, remix a source image while guiding the new result, or apply text-driven edits to an existing image.
How is Qwen Image different from Qwen 2?
They are separate model generations with different RunAPI model IDs. Choose Qwen Image when you need this original generation, remix, or edit workflow without conflating it with Qwen 2.
Can Qwen Image render text inside images?
Yes. Strong text rendering, including Chinese and English, is a core capability of the Qwen Image family.
What is the difference between remix and edit?
Remix reinterprets a source image under a new prompt, while edit applies more precise instructions to change selected content while preserving the rest of the composition.
Does Qwen Image support semantic image editing?
Yes. The edit model follows natural-language instructions to add, remove, or alter visual elements while retaining relevant scene context.
Which variant should I start with?
Pick the cheapest variant that meets your quality bar. Most teams start on the fast variant and graduate to pro for production.
Is there a free tier?
New accounts get free first calls on every model. After that, pay per call.
Do you stream results?
Where streaming is available, RunAPI streams end-to-end.
How are failures billed?
Failed generations are not charged.
Are outputs cached?
Generated outputs are stored and retrievable by task ID. Inputs are not cached.
Can I use commercially?
Yes — commercial use is included for every variant unless a model license explicitly restricts it, which is called out on the variant page.
What about rate limits?
Per-key rate limits scale with usage tier. See pricing page for current limits.
Where can I report issues?
Open an issue on the public GitHub repo or email support.