Image Editing

Create Image Editing Task

Feature Introduction

The intelligent image editing feature is a breakthrough technology that allows you to make deep and creative modifications to single or multiple images through simple text descriptions.

You only need to input natural language instructions (Prompts), and the algorithm can intelligently understand and execute a full range of edits — from content reconstruction (such as adding, removing, or replacing objects), style transfer (such as oil painting style, cyberpunk), to image quality enhancement, scene migration, and more. It combines visual elements from multiple reference images to achieve precise style blending and detail control, quickly transforming your imagination into visual reality.

Whether you are a professional designer exploring creative possibilities or an everyday user enhancing personal photos, this feature significantly lowers the barrier to professional editing, enabling everyone to easily achieve limitless possibilities from photo restoration to artistic creation.

API Reference

Create Image Editing Task

API Description

Invokes algorithmic capabilities based on the content uploaded by the user for image editing, ultimately returning a PNG file for user download. The PaaS platform supports 7-day online storage; timely transfer is required, as generated content will no longer be available for download after 7 days.

Request URL

POST /api/2dvh/v1/material/single/image/edit

Request Headers

Content-Type: application/json

Request Parameters

Field	Type	Required	Description
imageName	String	True	Image name
param	String	True	Correct param information must be passed in to create an image editing task, including various image editing parameters (this parameter is a JSON-escaped string)

Request Example

{
  "imageName": "xxx",
  "param": "{\"images\":[\"https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/33166f5a2c6b54aed18a1fb313bd04b9_20251224144112209.jpeg\",\"https://dwg-aigc-paas-prod.tos-cn-shanghai.volces.com/user-upload/506/8ddd8fe1d7de6f51223104b656a80963_20251224141011387.jpeg\",\"https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/442948967-%E5%90%AC%E5%8F%8B44294896.jpg\"],\"prompt\":\"图一和图二中的两个小女孩并排站着，牵着图三的小狗\",\"watermark\":{\"show\":true,\"content\":\"AI生成\"}}"
}

Response Elements

Field	Type	Required	Description
code	Integer	True	0 - Success, Other - Error
message	String	True	Error details
data	Integer	False	Task ID

Response Example

{
    "code": 0,
    "message": "success",
    "data": 1
}

JSON Parameter Description

Name	Type	Example	Required	Description
images	string[]	Yes	Input image URL list, supporting 1–3 images; single image resolution must not exceed 2K, file size must not exceed 10MB
prompt	string	Yes	Text prompt describing the content to generate or edit in the image
resolution	int[]	No	Output image resolution, format: [width, height], width and height must not exceed 2K; defaults to the resolution of the first input image
watermark	object	No	Image watermark configuration
└─ show	boolean	No	Whether to display the image watermark
└─ content	string	No	Watermark content; when show=true and content is not provided, the system will automatically generate default watermark content

{
  "images": ["https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/33166f5a2c6b54aed18a1fb313bd04b9_20251224144112209.jpeg", "https://dwg-aigc-paas-prod.tos-cn-shanghai.volces.com/user-upload/506/8ddd8fe1d7de6f51223104b656a80963_20251224141011387.jpeg", "https://dhs.blob.core.chinacloudapi.cn/share/i2v_test/442948967-%E5%90%AC%E5%8F%8B44294896.jpg"],
  "prompt": "图一和图二中的两个小女孩并排站着，牵着图三的小狗",
  "watermark": {
    "show": true,
    "content": "AI生成"
  }
}

The above covers all image editing capabilities provided by the platform.