Qwen Image Edit LoRA API: Editing with Reference Images

Overview

Qwen Image Edit LoRA is an asynchronous image-to-image editing model. Send one primary image URL, up to two optional reference image URLs, and a text prompt, then poll the task until the edited image is ready. Output composition and dimensions follow the primary image.

Capability	Value
Model ID	`qwen-image-edit-LoRA`
Mode	`image-to-image`
Input images	1–3 public image URLs: one primary image and up to two references
Prompt	Required
Optional seed	Non-negative integer
Result delivery	Async polling

Endpoint and authentication

Base URL:

https://api.apixo.ai/api/v1

Method	Endpoint	Purpose
`POST`	`/generateTask/qwen-image-edit-LoRA`	Submit an image editing task
`GET`	`/statusTask/qwen-image-edit-LoRA?taskId={taskId}`	Poll task status and retrieve results

All requests require your APIXO API key:

Authorization: Bearer YOUR_API_KEY

Submit requests also require:

Content-Type: application/json

Copy-paste async quickstart

curl -X POST "https://api.apixo.ai/api/v1/generateTask/qwen-image-edit-LoRA" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "image-to-image",
      "prompt": "change the jacket color to deep red while keeping the background unchanged",
      "image_urls": [
        "https://example.com/source-image.png"
      ],
      "seed": 12345
    }
  }'

Successful response:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678"
  }
}

Poll for result

curl -X GET "https://api.apixo.ai/api/v1/statusTask/qwen-image-edit-LoRA?taskId=task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"

Processing response:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "processing",
    "createTime": 1767965610929
  }
}

Success response:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_12345678",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://file.apixo.ai/edited-image.png\"]}",
    "createTime": 1767965610929,
    "completeTime": 1767965652317,
    "costTime": 41388
  }
}

Parse resultJson after state becomes success:

const payload = JSON.parse(data.resultJson);
const imageUrls = payload.resultUrls;

Request body

{
  "request_type": "async",
  "input": {
    "mode": "image-to-image",
    "prompt": "replace the sky with a soft sunset",
    "image_urls": [
      "https://example.com/source-image.jpg"
    ],
    "seed": 42
  }
}

Parameters

string

default:"async"

required

Result delivery mode. Use async and poll with statusTask.

object

required

Qwen Image Edit LoRA input parameters.

Show properties

string

required

Generation mode. This model supports image-to-image only.

string

required

Editing instruction. Must be a non-empty string.

string[]

required

Must contain 1–3 non-empty public image URLs. The first image is the primary image; the second and third are optional reference images used in array order. Output composition and dimensions follow the first image.

integer

Optional random seed. Use a fixed non-negative integer seed for more reproducible experiments.

Editing with reference images

Put the primary image first, followed by the reference images in the order described by your prompt. Existing single-image requests remain supported.

{
  "request_type": "async",
  "input": {
    "mode": "image-to-image",
    "prompt": "Edit the person in image 1 using the outfit from image 2 and the background from image 3",
    "image_urls": [
      "https://example.com/source-image.png",
      "https://example.com/outfit-reference.png",
      "https://example.com/background-reference.png"
    ],
    "seed": 42
  }
}

Response format

POST /generateTask/qwen-image-edit-LoRA returns a task ID when the task is accepted.

integer

API status code. 200 means the task was accepted.

string

Human-readable status message.

string

Unique task identifier used with the status endpoint.

Status response fields

string

Unique task identifier.

string

Current task state: pending, processing, success, or failed.

string

JSON string containing edited image URLs in resultUrls. Present when state is success.

string

Machine-readable failure code. Present when state is failed.

string

Human-readable failure message. Present when state is failed.

integer

Task creation timestamp in Unix milliseconds.

integer

Task completion timestamp in Unix milliseconds. Present after completion when available.

integer

Processing duration in milliseconds when available.

Billing

Qwen Image Edit LoRA is billed per generated image. The base price is $0.048, including one primary input image. Each additional reference image adds $0.003; the input count comes from image_urls. Price = $0.048 + (image_urls.length - 1) × $0.003

Input images	APIXO price per generated image
1 primary image	`$0.048`
1 primary + 1 reference image	`$0.051`
1 primary + 2 reference images	`$0.054`

For the current public price, see Pricing.

Latency and polling

This endpoint is asynchronous. Actual latency varies by image complexity and current queue load.

Use case	Recommended first poll	Poll interval
Standard image edit	10s after task creation	5s-10s

Errors and troubleshooting

Condition	What to do
Invalid or missing `mode`	Set `input.mode` to `image-to-image`
Missing or empty `prompt`	Send a non-empty edit instruction
Invalid `image_urls`	Send 1–3 non-empty public image URLs, with the primary image first
Invalid `seed`	Use a non-negative integer
Task stays `processing`	Continue polling with backoff
Task returns `failed`	Check `failCode` and `failMsg`, then adjust the input or retry

See Error Codes for the full error reference.

​Overview

​Endpoint and authentication

​Copy-paste async quickstart

​Poll for result

​Request body

​Parameters

​Editing with reference images

​Response format

​Status response fields

​Billing

​Latency and polling

​Errors and troubleshooting

​Related links

Overview

Endpoint and authentication

Copy-paste async quickstart

Poll for result

Request body

Parameters

Editing with reference images

Response format

Status response fields

Billing

Latency and polling

Errors and troubleshooting

Related links