## 接口简介本接口提供根据用户的草图与文本提示，进行实时绘图的能力。核心是参考用户绘制图片的框架结构，结合用户输入的文本提示，实时转化为精美的图像 ## 限制条件 |名称 |内容 | |---|---| |输入图要求 |1. 图片格式：JPG(JPEG), PNG, BMP 等常见格式, 建议使用JPG格式。 |\ | |2. 小于4.7MB，大于64\*64，小于4096 x 4096。 | |使用场景建议 |1. 针对输入图像做压缩的预处理（最好可压缩到几十KB），可极大提高延迟，加快出图效率；使用场景，建议前端结合画布类图像编辑器，建议将整张画布中多涂层内容整合后统一传入接口|\ | |2. 若不指定输出图片宽高（width、height参数），输出图片尺寸与输入图片一致|\ | |3. 若指定输出图片宽高（width、height参数），输出图片尺寸与所传宽高参数一致 | ## 请求说明 |名称 |内容 | |---|---| |接口地址 |[https://visual.volcengineapi.com](https://visual.volcengineapi.com/) | |请求方式 |POST | |**Content\-Type** |**application/json** | ### **Header参数** 完整公共参数列表见 [公共参数](https://www.volcengine.com/docs/6369/67268) 本服务**Region为cn\-north\-1，Service为cv** ### **Query参数** :::拼接到url后的参数，示例：[https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31](https://visual.volcengineapi.com?Action=CVProcess&Version=2022-08-31) |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |必选 |String |接口名，取固定值：**CVProcess** | |Version |必选 |String |版本号，取固定值：**2022\-08\-31** | ### **Body参数** :::warning 业务请求参数，放到request.body中，MIME\-Type为**application/json** ::: |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |req_key |必选 |String |算法名称，取**固定值为**img2img_ai_doodle_dreamina | |binary_data_base64 |必选（二选一） |array of string |图片文件，base64编码。此算法需输入1张图片 | |image_urls |必选（二选一） |array of string |图片文件URL。此算法需输入1张图片 | |prompt |可选 |String |用于生成图像的提示词，中英文均可输入，不建议输入过长内容 | |cfg |可选 |float |控制提示词与出图相关性|\ | | | ||\ | | | |* 参数越大，生成的图像与文本提示的相关性越高，但可能会失真。 |\ | | | |* 数值越小，相关性则越低，越有可能偏离提示或输入图像，但质量越好。 |\ | | | ||\ | | | |默认值：3.0|\ | | | |取值范围：[0.1, 10.0] | |strength |可选 |float |取值越小输出图与输入图关联参考性越大，取值越大与输入图参考性越小 |\ | | | |默认值：0.9924999999999999（推荐）|\ | | | |取值范围：（0.1, 1.0） | |steps |可选 |int |推理步数，决定输出图像精细程度，过高会导致处理时长较长|\ | | | |默认值：4|\ | | | |取值范围：[1, 8] | |seed |可选 |int |随机种子，作为确定扩散初始状态的基础，默认\-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致|\ | | | |默认值：\-1 | |width |可选 |int |控制生成图的宽，建议1024附近，|\ | | | |取值范围：[512, 2048] | |height |可选 |int |控制生成图的高，建议1024|\ | | | |取值范围：[512, 2048] | |return_url |可选 |bool |输出是否返回图片链接 **（链接有效期为24小时）** | |logo_info |可选 |LogoInfo |水印信息 | **LogoInfo** 水印相关参数 |名称 |类型 |必选 |描述 |备注 | |---|---|---|---|---| |add_logo |bool |否 |是否添加水印。True为添加，False不添加。默认不添加 | | |position |Int |否 |水印的位置，取值如下：| |\ | | | |0\-右下角| |\ | | | |1\-左下角| |\ | | | |2\-左上角| |\ | | | |3\-右上角| |\ | | | |默认0 | | |language |Int |否 |水印的语言，取值如下：| |\ | | | |0\-中文（AI生成）| |\ | | | |1\-英文（Generated by AI）| |\ | | | |默认0 | | |opacity |Float |否 |水印的不透明度，取值范围0\-1，1表示完全不透明，默认0.3 | | |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数组（单张图） | ## 请求&返回完整示例 ### **请求示例** ```json { "req_key": "img2img_ai_doodle_dreamina", // "binary_data_base64": [], "image_urls": [ "https://xxx" ], "prompt": "油画风", "cfg": 3.0, "strength": 0.9924999999999999, "steps": 4, "seed": -1, "controlnet_conditioning_scale": 1, "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" ] }, "message": "Success", "request_id": "20250317154931465BDB4B12B02DD91343", "status": 10000, "time_elapsed": "2.178031718s" } ``` ## 错误码 ### **通用错误码** 请参考[通用返回字段及错误码](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)

人像人体