## 接口简介指令编辑（SeedEdit）是一种能够使用任何文本提示修改给定图像的扩散模型，也是专为图像编辑任务设计的模型。在通用性、可控性、高质量等方面取得了新的突破，凭借创新、多尺度且多规则的数据获取和过滤方案，输入任意指令，即可实现精准编辑。 ## 核心优势 1）高精度指令理解，能理解中英文、专有名词：依托豆包文生图大模型，具备出色的指令理解能力。无论是中文还是英文输入，都能精准响应，对于成语、专有名词等复杂词汇也毫不逊色。 2）高质量编辑效果，聚焦目标，不“误伤”原图：它能够更加灵活、精准且快速地选择目标，在编辑过程中最大限度地保持原图的完整性。 3）高效率创新模型，可实现多元风格，美观自然：用户只需通过简单的指令调优，即可轻松完成诸如换背景、变换风格、物体增删、替换等丰富多样的编辑任务，极大地提高了编辑效率。 ## 限制条件 |名称 |内容 | |---|---| |输入图要求 |1. 图片格式：仅支持JPG(JPEG), PNG，建议使用JPG格式.|\ | |2. 图片要求：小于4.7 MB，小于4096\*4096|\ | |3. 长边与短边比例在3以内，超出此比例或比例相对极端，会导致报错 | |输出图说明 |1. 输出图分辨率与输入图宽高比有关，与原始分辨率大小无关。|\ | |2. 最终出图宽高比与原图接近，单边长度：[512, 1536]|\ | |3. 需要详细了解宽高规则，可再联系相关火山引擎同学 | ## **请求参数** |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |Content\-Type |application/json | #### **Query参数** :::tip 拼接到url后的参数，示例：[https://visual.volcengineapi.com?Action=](https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31)[CVProcess](https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31)[&Version=2022-08-31](https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31) ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，取值：**CVProcess** | |Version |必选 |String |版本号，取值：**2022\-08\-31** | #### **Header参数** :::warning 本服务固定值：**Region为cn\-north\-1，Service为cv** ::: 主要用于鉴权，详见 [公共参数](https://www.volcengine.com/docs/6369/67268) \- 签名参数 \- 在Header中的场景部分 #### **Body参数** :::warning 业务请求参数，放到request.body中，MIME\-Type为**application/json** ::: |参数 |可选/必选 |类型 |说明 |备注 | |---|---|---|---|---| |req_key |必选 |String |服务标识| |\ | | | |取固定值: **byteedit_v2.0_zi2i** | | |binary_data_base64 |必选（二选一） |array of string |图片文件，base64编码。此算法需输入1张图片 | | |image_urls |必选（二选一） |array of string |图片文件URL。此算法需输入1张图片 | | |prompt |必选 |String |用于编辑图像的提示词。建议：|参考示例|\ | | | ||添加/删除实体：添加/删除xxx（删除图上的女孩/添加一道彩虹）|\ | | | |* 编辑指令使用自然语言即可|修改实体：把xxx改成xxx（把手里的鸡腿变成汉堡）|\ | | | |* 每次编辑使用单指令会更好|修改风格：改成xxx风格（改成漫画风格）|\ | | | |* 局部编辑时指令描述尽量精准，尤其是画面有多个实体的时候，描述清楚对谁做什么，能获取更精准的编辑效果|修改色彩：把xxx改成xx颜色（把衣服改成粉色的）|\ | | | |* 发现编辑效果不明显的时候，可以调整一下编辑强度scale，数值越大越贴近指令执行|修改动作：修改表情动作（让他哭/笑/生气）|\ | | | |* 尽量使用清晰的，分辨率高的底图，动漫及豆包模型生成的图片编辑效果会更好。 |修改环境背景：背景换成xxx，在xxx（背景换成海边/在星空下） | |seed |可选 |int |随机种子，作为确定扩散初始状态的基础，默认\-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致 | | |scale |可选 |float |影响文本描述的程度，该值越大代表文本描述影响程度越大，且输入图片影响程度越小| |\ | | | |默认值：0.5| |\ | | | |取值范围：[0, 1] | | |return_url |可选 |bool |输出是否返回图片链接 **（链接有效期为24小时）** | | |logo_info |可选 |LogoInfo |水印信息 | | **LogoInfo** 水印相关参数 |名称 |类型 |必选 |描述 |备注 | |---|---|---|---|---| |add_logo |Boolean |否 |是否添加水印。True为添加，False不添加。默认不添加 | | |position |Int |否 |水印的位置，取值如下：| |\ | | | |0\-右下角| |\ | | | |1\-左下角| |\ | | | |2\-左上角| |\ | | | |3\-右上角| |\ | | | |默认0 | | |language |Int |否 |水印的语言，取值如下：| |\ | | | |0\-中文（AI生成）| |\ | | | |1\-英文（Generated by AI）| |\ | | | |默认0 | | |logo_text_content |String |否 |明水印自定义内容 | | ## 返回参数 #### **通用返回参数** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) #### **业务返回参数** :::tip 重点关注data 字段，其他字段为公共返回 ::: |字段 |类型 |说明 | |---|---|---| |binary_data_base64 |array of string |返回图片的base64数组。 | |image_urls |array of string |输出处理过的图片url|\ | | |数组（单张图）输出图片格式为jpeg格式 | ## 请求&返回Body部分完整示例 **请求示例：** ```JSON { "req_key": "byteedit_v2.0_zi2i", // "binary_data_base64": [], "image_urls": [ "https://xxx" ], "prompt": "修改成红色衣服", "negative_prompt": "", "seed": -1, "scale": 0.5, "return_url": true, "logo_info": { "add_logo": false, "position": 0, "language": 0, "logo_text_content": "这里是明水印内容" } } ``` ### **返回示例：** ```JSON { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "image_urls": [ "https://xxxx" ], "infer_ctx": { "algorithm_key": "high_aes_scheduler_seededit_v1.6", "app_key": "2100xxx", "created_at": "2025-04-24T17:31:15.660547898+08:00", "generate_id": "", "log_id": "202504241731056AE80EBE54A94EAE89AC", "params": { "app_id": "", "aspect_ratio": "", "common_params": "", "ddim_steps": 0, "edit_session_id": "", "fps": 0, "frames": 0, "group_name": "", "height": 1024, "input_image_url": "", "is_only_sr": false, "is_pe": false, "llm_result": "", "media_source": "", "n_samples": 0, "negative_prompt": "", "ori_prompt": "修改成红色毛发", "origin_request_id": "", "output_height": 1024, "output_width": 1024, "pe_result": "", "predict_tags_result": "", "rephraser_result": "", "req_key": "seededit_v16", "rescale": 0, "resolution": "", "scale": 0.5, "seed": 0, "shift": 0, "sr_img2img_fix_steps": 0, "sr_scale": 0, "sr_strength": 0.3, "sr_upscaler": "", "steps": 0, "strength": 0.3, "trace_id": "", "translate_negative_prompt": "", "translate_prompt": "", "use_pre_llm": false, "use_prompt_aug": false, "use_sr": true, "version_id": "", "video_url": "", "vlm_edit": "Instruction: 将鬃毛和面部毛发改为红色", "vlm_input": "一只毛发浓密的雄狮，有着棕黄色的鬃毛和面部毛发", "vlm_output": "一只毛发浓密的雄狮，有着红色的鬃毛和面部毛发", "width": 1024 }, "request_id": "a04f81492fc0e8ecc59957137cc02e2c27067344fd6f02c6c0b019ea8c759020", "session_id": "", "time_stamp": "1745487075" }, "llm_result": "", "pe_result": "", "predict_tags_result": "", "rephraser_result": "", "request_id": "a04f81492fc0e8ecc59957137cc02e2c27067344fd6f02c6c0b019ea8c759020", "vlm_result": "一只毛发浓密的雄狮，有着红色的鬃毛和面部毛发" }, "message": "Success", "request_id": "202504241731056AE80EBE54A94EAE89AC", "status": 10000, "time_elapsed": "10.618578556s" } ``` ## 错误码 ### **通用错误码** 请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ### **业务错误码** |HttpCode |错误码 |错误消息 |描述 | |---|---|---|---| |200 |10000 |无 |请求成功 | |400 |50411 |Pre Img Risk Not Pass |输入图片前审核未通过 | |400 |50511 |Post Img Risk Not Pass |输出图片后审核未通过 | |400 |50412 |Text Risk Not Pass |输入文本前审核未通过 | |400 |50512 |Post Text Risk Not Pass |输出文本后审核未通过 | |400 |50413 |Post Text Risk Not Pass |输入文本NER、IP、Blocklist等拦截 | ## 接入说明 ### SDK使用说明请参考[SDK使用说明](https://www.volcengine.com/docs/6444/1340578) ### HTTP方式接入说明请参考[HTTP请求示例](https://www.volcengine.com/docs/6444/1390583)

智能视觉服务