Skip to main content
POST
Create Generation Task

Overview

Edit images using text prompts with the Q Image Edit Spicy model (qwen-image-edit-spicy). Supports adding, removing, or modifying elements, style transfer, and other image editing operations. Keep the primary image in image and pass up to two additional images in reference_images. Output composition and dimensions follow the primary image; reference images are used in array order.

Key Features

  • Text-guided image editing
  • Add, remove, or modify image elements
  • Style transfer and background changes
  • Up to 3 images: one primary image plus two optional reference images
  • Optional random seed for reproducibility

Multi-image Rules

  • image is required and remains the primary image
  • reference_images is optional and accepts up to two image URLs or base64-encoded images
  • reference_images[0] is reference image 2; reference_images[1] is reference image 3
  • Omit reference_images, use null, or pass [] for single-image editing; existing single-image calls need no change
  • Unknown fields are ignored, preserving existing client behavior. Only reference_images supplies additional reference images.

Example Requests

Basic

With Seed

Two Images

Three Images

Pricing

Base price plus a surcharge for each additional reference image.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
image
string
required

Primary image to be edited. Supports an image URL or base64-encoded image data. Output composition and dimensions follow this image.

Minimum string length: 1
prompt
string
required

Text prompt describing the desired edit to apply to the image.

Minimum string length: 1
reference_images
string[] | null

Optional reference images as URLs or base64-encoded image data, up to two items. Items correspond to reference image 2 and reference image 3 in order. Omit, use null, or pass an empty array for single-image editing.

Maximum array length: 2
Minimum string length: 1
seed
integer | null

Random seed. null or 0 for random generation.

Response

202 - application/json

Accepted - Task created successfully

task_info
object