Image Edit

Edit images with Qwen Image Edit (2509) using model: Qubico/qwen-image and task_type: image-edit. Qwen Image 2.1 currently supports text-to-image only.

Each edit costs $0.025. Submit a task, then use Get task to retrieve its status and output.

prompt and image1 are required. image2 and image3 are optional reference images.

steps accepts 1–16, defaults to 8 when omitted or non-positive, and values above 16 are capped at 16.

seed is random when omitted or non-positive. Supply a positive integer for a selected seed.

flow_shift accepts 1–7 and uses the supplied value. Omitted or null defaults to 1; values below 1 become 1, and values above 7 become 7. Set 3 explicitly if desired.

denoise accepts 0–1, including 0. Omitted or null defaults to 1. Out-of-range values are rejected before image processing or credits are reserved.

negative_prompt: Accepted and encoded, but the current legacy workflow uses CFG=1, so negative_prompt does not provide classifier-free negative guidance.

A newly accepted pending edit reports meta.usage.type: point, frozen: 250000, and consume: 0. After successful completion, frozen is 0 and consume is 250000. Status values are lowercase; the output can be null before completion.

Request

Header Params

Body Params application/jsonRequired

Example

{
  "model": "Qubico/qwen-image",
  "task_type": "image-edit",
  "input": {
    "image1": "https://storage.theapi.app/images/playground/20250925/o9p630o1nbo.jpeg",
    "image2": "https://storage.theapi.app/images/playground/20250925/wwbydnvvg2.jpeg",
    "image3": "https://storage.theapi.app/images/playground/20250925/eo26tcgry1.jpeg",
    "prompt": "man in image1 wear a red shirt in image2 and a blue trouser in image3. change the background to a sea beach. Add a title 'ZARA' as a advertisement",
    "negative_prompt": "",
    "seed": -1,
    "steps": 8,
    "flow_shift": 3,
    "denoise": 1
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Bodyapplication/json

Example

Illustrative accepted edit: points are reserved while the task is pending.

{
  "code": 200,
  "data": {
    "task_id": "0ec8dffe-b68b-4f24-861b-98bcd5e62381",
    "model": "Qubico/qwen-image",
    "task_type": "image-edit",
    "status": "pending",
    "config": {
      "service_mode": "",
      "webhook_config": {
        "endpoint": "https://webhook.site/f608a6c5-61e3-4f56-89c6-d1ce1e1d54d7",
        "secret": ""
      }
    },
    "input": {
      "prompt": "man in image1 wear a red shirt in image2 and a blue trouser in image3. change the background to a sea beach. Add a title 'ZARA' as a advertisement",
      "negative_prompt": "",
      "image1": "https://storage.theapi.app/images/playground/20250925/o9p630o1nbo.jpeg",
      "image2": "https://storage.theapi.app/images/playground/20250925/wwbydnvvg2.jpeg",
      "image3": "https://storage.theapi.app/images/playground/20250925/eo26tcgry1.jpeg",
      "seed": -1,
      "steps": 8,
      "flow_shift": 3,
      "denoise": 0
    },
    "output": null,
    "meta": {
      "created_at": "2025-09-26T00:35:32.514142447Z",
      "started_at": "0001-01-01T00:00:00Z",
      "ended_at": "0001-01-01T00:00:00Z",
      "usage": {
        "type": "point",
        "frozen": 250000,
        "consume": 0
      },
      "is_using_private_pool": false
    },
    "detail": null,
    "logs": [],
    "error": {
      "code": 0,
      "raw_message": "",
      "message": "",
      "detail": null
    }
  },
  "message": "success"
}