# qwen-image/edit-2511

> Qwen Image Edit 2511 is a major upgrade over 2509 for real-world image editing and design. It delivers stronger edit consistency, robust multi-person identity/pose consistency, built-in LoRA styles, enhanced industrial/product design, and improved geometric reasoning for structure-preserving edits. Built for stable production use with a ready-to-use REST API, no cold starts, and predictable pricing.

- **Provider:** AirCube
- **Category:** image-to-image
- **Price:** $0.0200 per run

## Key Features

- Text-to-image and image editing unified — generate from scratch with a text prompt or edit an existing image in a single model.
- Strong edit consistency — preserves identity, pose, and structural integrity across edits.
- Multi-person identity and pose consistency — handles complex scenes with multiple subjects.
- Enhanced industrial and product design — improved quality for product shots and design iterations.
- Improved geometric reasoning — structure-preserving edits that maintain spatial relationships.
- HD and FHD quality tiers — choose between speed (HD) and detail (FHD).
- Wide aspect ratio support — 9 options including ultra-wide 21:9 and 9:21.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `prompt` | Yes | Description of the image to generate or the edit to apply. |
| `image` | No | A source image URL to edit. Omit for text-to-image generation. |
| `aspect_ratio` | No | Aspect ratio: 1:1 (default), 9:16, 16:9, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21. |
| `resolution` | No | Output quality: '1k' (HD, default) or '2k' (FHD). |

## How to Use

1. For text-to-image: provide a prompt describing your desired image.
2. For image editing: provide a source image URL and describe the change you want.
3. Choose aspect ratio from 9 available options to match your output needs.
4. Select '1k' for fast iteration or '2k' for higher-detail output.

## Code Examples

### Python

```python
import os
import requests

response = requests.post(
    "https://aircube.ai/api/v3/qwen-image/edit-2511",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
    "image": "https://example.com/product-photo.jpg",
    "aspect_ratio": "1:1",
    "resolution": "2k"
},
    timeout=300,
)
data = response.json()

if data["success"]:
    print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
    print("Error:", data["error"]["message"])
```

### Node.js

```javascript
const response = await fetch("https://aircube.ai/api/v3/qwen-image/edit-2511", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.AIRCUBE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
  "image": "https://example.com/product-photo.jpg",
  "aspect_ratio": "1:1",
  "resolution": "2k"
}),
});

const data = await response.json();

if (data.success) {
  console.log("ID:", data.data.id, "Status:", data.data.status);
} else {
  console.error("Error:", data.error.message);
}
```

### cURL

```curl
curl -X POST "https://aircube.ai/api/v3/qwen-image/edit-2511" \
  -H "Authorization: Bearer $AIRCUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
  "image": "https://example.com/product-photo.jpg",
  "aspect_ratio": "1:1",
  "resolution": "2k"
}'
```

### Python (Async)

```python
import os
import time
import requests

# 1. Submit
response = requests.post(
    "https://aircube.ai/api/v3/qwen-image/edit-2511",
    headers={
        "Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
        "Content-Type": "application/json",
    },
    json={
    "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
    "image": "https://example.com/product-photo.jpg",
    "aspect_ratio": "1:1",
    "resolution": "2k"
},
    timeout=300,
)
data = response.json()

if not data["success"]:
    print("Error:", data["error"]["message"])
    exit(1)

generation_id = data["data"]["id"]
print(f"Submitted: {generation_id}")

# 2. Poll until completed
while True:
    time.sleep(5)
    r = requests.get(
        f"https://aircube.ai/api/v3/status/{generation_id}",
        headers={"Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"]},
    )
    result = r.json()["data"]

    if result["status"] == "completed":
        print(result["output_url"])
        break
    elif result["status"] == "failed":
        print("Generation failed")
        break
```

### Node.js (Async)

```javascript
// 1. Submit
const response = await fetch("https://aircube.ai/api/v3/qwen-image/edit-2511", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.AIRCUBE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
  "image": "https://example.com/product-photo.jpg",
  "aspect_ratio": "1:1",
  "resolution": "2k"
}),
});
const data = await response.json();

if (!data.success) {
  console.error("Error:", data.error.message);
  process.exit(1);
}

const generationId = data.data.id;
console.log("Submitted:", generationId);

// 2. Poll until completed
while (true) {
  await new Promise((r) => setTimeout(r, 5000));
  const res = await fetch(
    `https://aircube.ai/api/v3/status/${generationId}`,
    { headers: { "Authorization": "Bearer " + process.env.AIRCUBE_API_KEY } },
  );
  const result = (await res.json()).data;

  if (result.status === "completed") {
    console.log(result.output_url);
    break;
  } else if (result.status === "failed") {
    console.error("Generation failed");
    break;
  }
}
```

### cURL (Async)

```curl
# 1. Submit
RESPONSE=$(curl -s -X POST "https://aircube.ai/api/v3/qwen-image/edit-2511" \
  -H "Authorization: Bearer $AIRCUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Replace the background with a clean white studio, keep the product in the center with soft lighting",
  "image": "https://example.com/product-photo.jpg",
  "aspect_ratio": "1:1",
  "resolution": "2k"
}')

ID=$(echo "$RESPONSE" | jq -r '.data.id')
echo "Submitted: $ID"

# 2. Poll until completed
while true; do
  sleep 5
  STATUS_RES=$(curl -s "https://aircube.ai/api/v3/status/$ID" \
    -H "Authorization: Bearer $AIRCUBE_API_KEY")
  STATUS=$(echo "$STATUS_RES" | jq -r '.data.status')

  if [ "$STATUS" = "completed" ]; then
    echo "$STATUS_RES" | jq -r '.data.output_url'
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Generation failed"; break
  fi
done
```

## Pricing

| Resolution | Duration | Cost |
| --- | --- | --- |
| 1k | per image | $0.02 |
| 2k | per image | $0.03 |

### Billing Rules

- Per image: 1k: $0.02, 2k: $0.03.
- Failed generations are not charged.

## Best Use Cases

- Product photo editing — enhance, retouch, or restyle product images while preserving product identity.
- Creative retouching — modify elements, swap backgrounds, or change visual style with natural language.
- Multi-person scene editing — adjust poses, clothing, or expressions while maintaining identity consistency.
- Design iteration — rapidly explore variations of a concept from a reference image.
- Style transfer — apply artistic styles from a reference image to new compositions.
- E-commerce optimization — enhance product images and generate variations for A/B testing.

## Pro Tips

- Be specific about what to change — 'replace the background with a minimalist studio' works better than 'change the background'.
- Use FHD (2k) resolution for production assets and HD (1k) for quick iterations.
- For text-to-image use, include detailed style and lighting descriptions for best results.
- Aspect ratio 21:9 and 9:21 are available for ultra-wide or ultra-tall compositions.
- Provide a high-quality source image for the best edit blending results.

## Notes

- Dual-mode: text-to-image when no image provided, image editing when an image is included.
- 9 aspect ratio options available including ultra-wide 21:9.
- HD resolution: up to 1024px on longest side. FHD: up to 1280px.

## FAQ

**Q: What is the Qwen Image Edit 2511 API?**

An image generation and editing API powered by the Qwen Image Edit 2511 model. It can generate images from text prompts or edit an existing image using natural language instructions.

**Q: How is this different from GPT Image 2 Edit?**

Qwen Image Edit 2511 costs significantly less ($0.02–$0.03 vs $0.02–$0.73), and excels at identity/pose consistency and structure-preserving edits. GPT Image 2 Edit supports up to 16 input images.

**Q: Can I use it for text-to-image generation?**

Yes — simply omit the image parameter and provide only a text prompt to generate images from scratch.

**Q: How much does it cost?**

HD (1k) resolution: $0.02 per image. FHD (2k) resolution: $0.03 per image. Failed generations are not charged.

**Q: What aspect ratios are supported?**

Nine options: 1:1, 9:16, 16:9, 4:3, 3:4, 3:2, 2:3, 21:9, and 9:21.

**Q: Can I use generated images commercially?**

Yes — all outputs are yours to use commercially.