Name: Text-to-Image API with Chinese Text Rendering (Qwen-Image-2)
Brand: magicapi
SKU: api-magicapi-text-to-image-chinese-rendering-qwen-qwen-image-2
Availability: InStock
Author: API Market

Shashank Agarwal

# 🖼️ Text-to-Image Generator API - Strong Chinese Text Rendering (Qwen-Image-2)

## Overview
Qwen-Image-2 is an image generation and editing model from Alibaba's Qwen team. It creates images from a text prompt and can also edit an image you provide. It has strong text rendering, especially for Chinese, which makes it a good fit for images that contain signs, labels, posters or other written text.

Each request returns one image as a URL.

## Features
- **Text to image**: describe the image in `prompt`.
- **Image editing**: pass a reference image in `image` for image editing, style transfer or image-to-image generation, and describe the change in `prompt`.
- **Text rendering**: strong rendering of written text in images, especially Chinese.
- **Aspect ratio**: `1:1` (default), `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1` or `1:2`. With an input image, `match_input_image` uses the input's aspect ratio and resolution instead.
- **Prompt expansion**: `enable_prompt_expansion` (on by default) automatically expands and optimizes your prompt.
- **Negative prompt**: list elements to avoid in `negative_prompt`.
- **Reproducible results**: set `seed` (0 to 2147483647) to repeat a generation.

## Use Cases
1. **Signs and posters**: generate shop signs, posters and banners with the wording you specify.
2. **Chinese language visuals**: create marketing images and social posts that include Chinese text.
3. **Editing existing images**: change details of a photo or apply a new style by passing it in `image`.
4. **Product and packaging mockups**: produce concept images with labels and short copy on them.

## Visual Examples

Prompt used (all other fields at their defaults: `1:1`, prompt expansion on):

> A chalkboard sign outside a small cafe that reads 'api.market coffee, open daily', hand lettering, street photo

![Image generated by Qwen-Image-2 from the chalkboard sign prompt above](https://blog.api.market/wp-content/uploads/2026/10/qwen-image-2-output-api-market.webp)

## Pricing
- Pay As You Go (PAYG) pricing: you only pay for what you use.
- Price: $0.044 per API unit.
- 1 API unit = 1 output image. Each request returns one image, so each successful request costs $0.044.
- Failed or cancelled predictions are not billed.
- GET requests to check prediction status (GET /api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2/predictions/{id}) are free and don't count toward API unit usage.
- No monthly subscription fee.

## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2`

### Authentication
Include your api.market API key in the `x-api-market-key` header of every request:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
This API is asynchronous:

1. Send a POST request to `/predictions`. A successful request returns **201 Created** with a prediction `id` and a `status` of `starting` or `processing`. 201 means the prediction was accepted; it is not an error.
2. Poll GET `/predictions/{id}` (about once per second) while `status` is `starting` or `processing`.
3. Stop when `status` is `succeeded` (read the result from `output`), `failed` (see `error`) or `canceled`.

### Endpoints

#### Create a Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "266e594fa007032292c211586354fe193d7aa4e675a1eeb0aef0c6a424468ddd",
    "input": {
      "prompt": "A chalkboard sign outside a small cafe that reads 'api.market coffee, open daily', hand lettering, street photo"
    }
  }'
```

Response (201 Created):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "version": "266e594fa007032292c211586354fe193d7aa4e675a1eeb0aef0c6a424468ddd",
  "status": "starting",
  "created_at": "2026-10-13T10:33:40.967Z"
}
```

#### Check Prediction Status
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

Response when the prediction has finished (200 OK):
```json
{
  "id": "ufawqhfynnddngldkgtslldrkq",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2026/10/qwen-image-2-output-api-market.webp",
  "error": null,
  "created_at": "2026-10-13T10:33:40.967Z",
  "started_at": "2026-10-13T10:33:41.512Z",
  "completed_at": "2026-10-13T10:34:02.104Z"
}
```

### Input Parameters

| Name | Type | Default | Allowed values | Required | Description |
|------|------|---------|----------------|----------|-------------|
| `prompt` | string |  | Any text | Yes | Text prompt for image generation or editing. |
| `image` | string (URI) or null |  | Image URL | No | Optional reference image for image editing, style transfer, or image-to-image generation. |
| `match_input_image` | boolean | `false` | `true`, `false` | No | When true and an image is provided, use the input image's aspect ratio and resolution instead of `aspect_ratio`. |
| `aspect_ratio` | string | `1:1` | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2` | No | Aspect ratio of the generated image. |
| `enable_prompt_expansion` | boolean | `true` | `true`, `false` | No | Automatically expand and optimize the prompt for better results. |
| `negative_prompt` | string | `""` | Any text | No | Negative prompt to specify elements to avoid in the generated image. |
| `seed` | integer or null |  | 0 to 2147483647 | No | Random seed for reproducible generation. |

### Output
`output` is a single URL (string) pointing to the generated image.

### Status Codes

| Status code | Meaning | What to do |
|-------------|---------|------------|
| 200 OK | GET returned the prediction | Check `status`; keep polling while it is `starting` or `processing`. |
| 201 Created | POST accepted, prediction created | Success. Poll GET `/predictions/{id}` with the returned `id`. |
| 400 Bad Request | Invalid input (for example a missing `prompt` or an unsupported `aspect_ratio`) | Fix the request body and send it again. |
| 401 Unauthorized | Missing or invalid API key | Send a valid key in the `x-api-market-key` header. |
| 403 Forbidden | The key is not allowed to use this API | Check your subscription for this API. |
| 404 Not Found | Unknown prediction ID or wrong URL | Check the base URL and the prediction `id`. |
| 429 Too Many Requests | Rate limit exceeded | Wait and retry with backoff. |
| 500 Internal Server Error | Server-side error | Retry; if it keeps happening, contact us. |
| 503 Service Unavailable | Service temporarily unavailable | Retry after a short wait. |

### Rate Limits

All plans allow 10 requests per second. Requests above that return `429 Too Many Requests`; back off before retrying and honour any `Retry-After` header. Polling a prediction with GET is free but still counts toward the per-second limit, so poll every 1 to 5 seconds rather than in a tight loop.

## Implementation Guide

### Example Code

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2";

async function createAndWaitForPrediction(inputData) {
  // Step 1: create the prediction (201 Created on success)
  const response = await fetch(`${baseUrl}/predictions`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey
    },
    body: JSON.stringify({ version: "266e594fa007032292c211586354fe193d7aa4e675a1eeb0aef0c6a424468ddd", input: inputData })
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status} ${await response.text()}`);
  }

  const prediction = await response.json();

  // Step 2: poll for the result
  return await pollForResults(prediction.id);
}

function delay(ms) {
  return new Promise(resolve => setTimeout(resolve, ms));
}

async function pollForResults(predictionId) {
  const MAX_TIMEOUT = 600000; // 600 seconds (10 minutes)
  const POLL_INTERVAL = 1000; // 1 second between checks
  const startTime = Date.now();

  while (Date.now() - startTime < MAX_TIMEOUT) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: { "x-api-market-key": apiKey }
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${await response.text()}`);
    }

    const prediction = await response.json();

    if (prediction.status === "succeeded") {
      return prediction.output;
    }

    if (prediction.status === "failed" || prediction.status === "canceled") {
      throw new Error(`Prediction ${prediction.status}: ${prediction.error || "Unknown error"}`);
    }

    await delay(POLL_INTERVAL);
  }

  throw new Error("Prediction timed out after 10 minutes");
}

createAndWaitForPrediction({
  "prompt": "A chalkboard sign outside a small cafe that reads 'api.market coffee, open daily', hand lettering, street photo"
})
  .then(output => console.log(output))
  .catch(error => console.error(error));
```

#### Python
```python
import time
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2"

def create_and_wait_for_prediction(input_data):
    # Step 1: create the prediction (201 Created on success)
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers={"Content-Type": "application/json", "x-api-market-key": API_KEY},
        json={"version": "266e594fa007032292c211586354fe193d7aa4e675a1eeb0aef0c6a424468ddd", "input": input_data},
    )
    if response.status_code not in (200, 201):
        raise Exception(f"API error: {response.status_code} {response.text}")

    # Step 2: poll for the result
    return poll_for_results(response.json()["id"])

def poll_for_results(prediction_id):
    MAX_TIMEOUT = 600  # 600 seconds (10 minutes)
    POLL_INTERVAL = 1  # 1 second between checks
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()

    while time.time() - start_time < MAX_TIMEOUT:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)
        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")

        prediction = response.json()
        if prediction["status"] == "succeeded":
            return prediction["output"]
        if prediction["status"] in ("failed", "canceled"):
            raise Exception(f"Prediction {prediction['status']}: {prediction.get('error') or 'Unknown error'}")

        time.sleep(POLL_INTERVAL)

    raise Exception("Prediction timed out after 10 minutes")

print(create_and_wait_for_prediction({
    "prompt": "A chalkboard sign outside a small cafe that reads 'api.market coffee, open daily', hand lettering, street photo"
}))
```

#### cURL
```bash
# Step 1: create a prediction (returns 201 Created with an id)
curl -X POST "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "266e594fa007032292c211586354fe193d7aa4e675a1eeb0aef0c6a424468ddd",
    "input": {
      "prompt": "A chalkboard sign outside a small cafe that reads 'api.market coffee, open daily', hand lettering, street photo"
    }
  }'

# Step 2: check the prediction (replace PREDICTION_ID with the id from step 1)
# Repeat about once per second until status is succeeded, failed or canceled.
curl -X GET "https://prod.api.market/api/v1/magicapi/text-to-image-chinese-rendering-qwen-qwen-image-2/predictions/PREDICTION_ID" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

### Performance Optimization
- Put the exact wording you want rendered in quotes inside the prompt, as in the example above.
- Turn off `enable_prompt_expansion` if you want the model to follow your prompt as written.
- When editing, set `match_input_image` to `true` to keep the input's aspect ratio and resolution.

## FAQ

**Can it edit an existing image?**
Yes. Pass the image URL in `image` and describe the change in `prompt`.

**Which languages can it render as text in images?**
The model is described as having strong text rendering, especially for Chinese. The example above renders English text.

**What does prompt expansion do?**
When `enable_prompt_expansion` is `true` (the default), the model automatically expands and optimizes your prompt before generating. Set it to `false` to use your prompt as written.

**How do I get the same result again?**
Send the same input with the same `seed` (0 to 2147483647).

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Generate and edit images with Qwen-Image-2 from Alibaba's Qwen team. Strong text rendering, especially for Chinese. $0.044 per image.