# 接口简介即梦同款V2.1文生图API，精准解读文字片输入，生成符合语意和有独特审美的图像内容。无缝衔接创意构思与视觉呈现，一键实现「所见即所想」。本服务重点支持了中英文字符渲染。常用提示词（prompt）建议：【艺术风格】+【主体描述】+【文字排版】 * 艺术风格：确定画面整体基调，如写实风、插画风，或更具体的风格，如中国水墨风等； * 画面主体描述：聚焦主画面内容，例如描述海报中的人物正在做某件事，或具体的物品形态与状态等； * 文字排版描述：将文字内容放在双引号“”内，同时通过指令描述文字的位置、大小、颜色和风格，精准调整排版效果。可运用模版格式，根据需求灵活调整描述，当暂时没有明确灵感时，可尝试用简短的描述生成初稿，从中提炼创意，再通过迭代优化提示词，逐步实现理想效果。 # 产品优势 * **文字生成能力：** 支持生成准确的中文汉字和英文字母 * **构图：** 整体在景别、视角方面变化多样性提升明显，画面层次感增强 * **光影：** 去除了刻意的光线表达，画面表现更加真实自然 * **色彩：** 画面色调统一性增强，去除了大部分高对比混乱杂色 * **质感：** 人物皮肤磨皮感及油腻感减弱，人像、动物及材质类类纹理质感表现更加真实细腻 * **细节丰富度：** 简化了过于繁琐的画面元素，画面整体表现现更加具有层次感、秩序感 # Demo展示 |类型 |prompt |效果图 | |---|---|---| |**文字海报** |制作一张vlog视频封面。马卡龙配色，美女旅游照片+色块的拼贴画风格，主文案是“威海旅游vlog”，副文案是“特种兵一日游被低估的旅游城市”，海报主体是一个穿着短裙、梳双马尾的少女，人物白色描边 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2d38d60898d6fb0e29cf32f55ab6b87b.png) | |**浪漫水彩** |工笔画风格，三维古风，东方禅意，航拍高角度视角，捕捉了海底极小人物的奔跑追逐；构图大面积留白和丰富的光影，背景以水墨晕染展现水中阳光的多彩折射，现实与虚拟相结合的思考，水墨风格，蓝绿色调，逆光和辉光效果增强冷暖对比，高角度拍摄景深感，整体画面高清，画质通透，发光呈现幽静空灵感 |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_7198cf2f81cbf58ae893f8da9ded0685.jpeg) |\ | | | | |**胶片梦核** |过曝，强对比，夜晚，雪地里，巨大的黄色浴缸，小狗泡澡带墨镜，在喝红酒，胶片摄影，毛刺质感，复古滤镜，夜晚，过度曝光，古早，70年代摄影，复古老照片，闪光灯拍摄，闪光灯效果，过曝，过度曝光，闪光灯过曝，极简，高饱和复古色，70s vintage photography, vintage, retro style |![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2b01130cdcbd08d4874cd3c3cff86604.png) |\ | | | | # Prompt建议 * 建议1：提示词结构指南参照如下 * 当需要更准确的描述词响应时：主体描述+风格+美学 * 当需要更高的美学表现时：风格+主体描述+美学+氛围使用专业的短词语形容风格、镜头语言等美学描述；使用自然语言完整连贯的描述你画面的主体描述(主体+行为+环境)；当输入的提示词较多时，可以把要重点突出的内容放置在最前面。 * 建议2：用需要表达的正向提示词替换"不要xxx"这类负面描述词 * 建议3：通过以下方式让文字生成更可控 * 可以通过明确"文字"生成来强调,帮助模型理解 > Before:海报,"新年快乐" > After:一张海报,上面文字写着:"新年快乐" * 增加详细的位置、风格描述,可以让文字生成更可控: > Before:海报,"新年快乐" > After:一张海报,画面上方有手写涂鸦风格的文字写着:"新年快乐 * 建议4：画面重点特征强调 * 对于复杂内容可以反复强调 > 例如： > 御剑飞行\-\>男人站在剑上,他踩在剑上,剑被他踩着,御剑飞仙,飞行 > 男子向右看\-\>一个头转向右侧的男子,他看向右边 > 前景虚化\-\>前景中的玫瑰花被模糊,浅景深,前景虚化,前景构图 * 对于美学特征可以反复强调,添加从"哪里"看 > 例如： > 大透视、仰视视角\-\>采用低角度拍摄,从下往上,以仰视构图和广角构图的方式 > 仰视视角\-\>仰视构图,从建筑底部拍摄的视角,低角度拍摄 * 强化视角可以重点描述部分内容 > 例如：南瓜羹\-\>画面展现一碗百合南瓜羹的一半,米黄色的糯米粉勾芡,块块橙色南瓜在橙色粥中,南瓜丝丝沙沙质感,紫白色百合点缀 ## 服务开通 * [开通服务](https://console.volcengine.com/ai/ability/detail/10)

## **请求参数** |名称 |内容 | |---|---| |接口地址 |[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 |服务标识，取固定值: jimeng_high_aes_general_v21_L | | |prompt |是 |string |用于生成图像的提示词，中英文均可输入| |\ | | | |prompt书写规范参考上文描述 | | |seed |可选 |int |随机种子，作为确定扩散初始状态的基础，默认\-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致| |\ | | | |默认值：\-1 | | |width |可选 |int |生成图像的宽|宽、高与512差距过大，则出图效果不佳、延迟过长概率显著增加。|\ | | | |默认值：512|超分前建议比例及对应宽高：width\*height|\ | | | |取值范围：[256, 768] ||\ | | | | |* 1:1：512\*512|\ | | | | |* 4:3：512\*384|\ | | | | |* 3:4：384\*512|\ | | | | |* 3:2：512\*341|\ | | | | |* 2:3：341\*512|\ | | | | |* 16:9：512\*288|\ | | | | |* 9:16：288\*512 | |height |可选 |int |生成图像的高|^^|\ | | | |默认值：512| |\ | | | |取值范围：[256, 768] | | |use_pre_llm |可选 |bool |开启文本扩写，会针对输入prompt进行扩写优化，如果输入prompt较短建议开启，如果输入prompt较长建议关闭|1. prompt过短，如长度小于4时，推荐扩写默认打开，保证出图效果更优；|\ | | | |默认值：true |2. prompt较长，如出图4张，可考虑1次关闭扩写，3次打开扩写，保证出图效果多样性 | |use_sr |可选 |bool |True：文生图+AIGC超分|内置的超分功能，开启后可将上述宽高均乘以2返回，此参数打开后延迟会有增加|\ | | | |False：文生图|如上述宽高均为512和512，此参数关闭出图 512\*512 ，此参数打开出图1024 \* 1024 |\ | | | |默认值：true | | |return_url |可选 |bool |输出是否返回图片链接 **（链接有效期为24小时）** | | |logo_info |可选 |LogoInfo |水印信息 | | |aigc_meta |可选 |AIGCMeta |隐式标识 |隐式标识验证方式：|\ | | | | ||\ | | | | |1. 查看【png】或【mp4】格式，人工智能生成合成内容表示服务平台（后续预计增加jpg）|\ | | | | |* [https://www.gcmark.com/web/index.html#/mark/check/image](https://www.gcmark.com/web/index.html#/mark/check/image)|\ | | | | |2. 查看【jpg】格式，使用app11 segment查看aigc元数据内容|\ | | | | |* 如 [https://cyber.meme.tips/jpdump/#](https://cyber.meme.tips/jpdump/#) | ## **LogoInfo** 水印相关信息。 |名称 |类型 |必选 |描述 |备注 | |---|---|---|---|---| |add_logo |Boolean |否 |是否添加水印。True为添加，False不添加。默认不添加 | | |position |Int |否 |水印的位置，取值如下：| |\ | | | |0\-右下角| |\ | | | |1\-左下角| |\ | | | |2\-左上角| |\ | | | |3\-右上角| |\ | | | |默认0 | | |language |Int |否 |水印的语言，取值如下：| |\ | | | |0\-中文（AI生成）| |\ | | | |1\-英文（Generated by AI）| |\ | | | |默认0 | | |opacity |Float |否 |水印的不透明度，取值范围0\-1，1表示完全不透明，默认1 | | |logo_text_content |String |否 |明水印自定义内容 | | ##### AIGCMeta 隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》 |名称 |类型 |**可选/必选** |描述 | |---|---|---|---| |content_producer |String |可选 |内容生成服务ID | |producer_id |String |必选 |内容生成服务商给此图片数据的唯一ID | |content_propagator |String |可选 |内容传播服务商ID | |propagate_id |String |可选 |传播服务商给此图片数据的唯一ID | ## 返回参数 #### **通用返回参数** 请参考[通用返回字段及错误码](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": "jimeng_high_aes_general_v21_L", "prompt": "站在树林里", "return_url": true, "logo_info": { "add_logo": false, "position": 0, "language": 0, "opacity": 1, "logo_text_content": "这里是明水印内容" }, "aigc_meta": { "content_producer": "xxx", "producer_id": "xxx", "content_propagator": "xxx", "propagate_id": "xxx" } } ``` **返回示例：** ```JSON { "code": 10000, "data": { "algorithm_base_resp": { "status_code": 0, "status_message": "Success" }, "binary_data_base64": [], "image_urls": [ "https://xxx.jpg" ], "infer_ctx": { "algorithm_key": "high_aes_scheduler_general_v2.1_L", "app_key": "2100223643", "created_at": "2025-04-22T15:07:11.151025556+08:00", "generate_id": "", "log_id": "2025042215070738BA47D4CACE51646761", "params": { "app_id": "", "aspect_ratio": "", "common_params": "", "ddim_steps": 16, "edit_session_id": "", "fps": 0, "frames": 0, "group_name": "", "height": 512, "input_image_url": "", "is_only_sr": false, "is_pe": false, "llm_result": "", "media_source": "", "n_samples": 0, "negative_prompt": "nsfw, nude, low resolution, blurry, worst quality, mutated hands and fingers, poorly drawn face, bad anatomy, distorted hands", "ori_prompt": "小男孩在遛狗", "origin_request_id": "", "output_height": 512, "output_width": 512, "pe_result": "", "predict_tags_result": "", "rephraser_result": "现代生活摄影风格，自然光，低角度拍摄。一位小男孩正在遛一只狗；他穿着蓝色T恤和短裤，手中握着牵引绳。小狗是一只金毛寻回犬，显得活泼而友好。他们沿着公园的小路行走，周围是绿色的草地和树木。阳光透过树叶洒下斑驳光影，营造出轻松愉快的氛围，纪实摄影风，低角度视角。", "req_key": "high_aes_general_v21_L", "rescale": 0, "resolution": "", "scale": 3.5, "seed": -1, "shift": 0, "sr_img2img_fix_steps": 0, "sr_scale": 0, "sr_strength": 0.4, "sr_upscaler": "", "steps": 0, "strength": 0.4, "trace_id": "", "translate_negative_prompt": "nsfw, nude, low resolution, blurry, worst quality, mutated hands and fingers, poorly drawn face, bad anatomy, distorted hands", "translate_prompt": "小男孩在遛狗", "use_pre_llm": false, "use_prompt_aug": false, "use_sr": false, "version_id": "", "video_url": "", "vlm_edit": "", "vlm_input": "", "vlm_output": "", "width": 512 }, "request_id": "8cd71ccabaea0df425b0ff0ded6269eb020d87cd3300a7f88118a7577806a941", "session_id": "", "time_stamp": "1745305631" }, "llm_result": "现代生活摄影风格，自然光，低角度拍摄。一位小男孩正在遛一只狗；他穿着蓝色T恤和短裤，手中握着牵引绳。小狗是一只金毛寻回犬，显得活泼而友好。他们沿着公园的小路行走，周围是绿色的草地和树木。阳光透过树叶洒下斑驳光影，营造出轻松愉快的氛围，纪实摄影风，低角度视角。", "pe_result": "", "predict_tags_result": "", "rephraser_result": "现代生活摄影风格，自然光，低角度拍摄。一位小男孩正在遛一只狗；他穿着蓝色T恤和短裤，手中握着牵引绳。小狗是一只金毛寻回犬，显得活泼而友好。他们沿着公园的小路行走，周围是绿色的草地和树木。阳光透过树叶洒下斑驳光影，营造出轻松愉快的氛围，纪实摄影风，低角度视角。", "request_id": "8cd71ccabaea0df425b0ff0ded6269eb020d87cd3300a7f88118a7577806a941", "vlm_result": "" }, "message": "Success", "request_id": "2025042215070738BA47D4CACE51646761", "status": 10000, "time_elapsed": "4.396915546s" } ``` ## 错误码 ### **通用错误码** 请参考[通用返回字段及错误码](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 |输入文本含敏感词、版权词等审核不通过 |不需要 | |400 |50518 |Pre Img Risk Not Pass: Copyright |输入版权图前审核未通过 |不需要 | |400 |50519 |Post Img Risk Not Pass: Copyright |输出版权图后审核未通过 |可重试 | |400 |50520 |Risk Internal Error |审核服务异常 |不需要 | |400 |50521 |Antidirt Internal Error |版权词服务异常 |不需要 | |400 |50522 |Image Copyright Internal Error |版权图服务异常 |不需要 | |429 |50429 |Request Has Reached API Limit, Please Try Later |QPS超限 |可重试 | |429 |50430 |Request Has Reached API Concurrent Limit, Please Try Later |并发超限 |可重试 | |500 |50500 |Internal Error |内部错误 |不需要 | |500 |50501 |Internal RPC Error |内部算法错误 |不需要 | ## 接入说明 ### SDK使用说明请参考[SDK使用说明](https://www.volcengine.com/docs/6444/1340578) ### HTTP方式接入说明请参考[HTTP请求示例](https://www.volcengine.com/docs/6444/1390583) ## 最佳实践暂无，待补充

即梦AI