即梦AI-图片生成4.0-接口文档（公测）
最近更新时间：2025.09.22 11:08:14
首次发布时间：2025.09.05 11:08:32
我的收藏
有用
无用
接口简介
即梦4.0是即梦同源的图像生成能力，该能力在统一框架内集成了文生图、图像编辑及多图组合生成的功能：支持单次输入最多 10 张图像及进行复合编辑，并能通过对提示词的深度推理，自动适配最优的图像比例尺寸与生成数量，可一次性输出最多 15 张内容关联的图像。此外，模型显著提升了中文生成的准确率与内容多样性，且支持 4K 超高清输出，为专业图像创作提供了从生成到编辑的一站式解决方案。
接入说明
限制条件
名称
内容
输入图要求
图片格式：仅支持JPEG、PNG格式，建议使用JPEG格式；
图片文件大小：最大 15MB，支持最多输入10张图；
图片分辨率：最大 4096 * 4096；
输入图宽高比：（宽/高）范围：[1/3, 3]
输出图说明
输出图详细宽高规则，参考下方width、height中参数描述；
输出图会以列表形式返回，最大输出图数量 = 15 - 输入图数量；
其他说明
输出图片的分辨率越大、输出图片数量越多、输入图片数量越多，延迟增加越明显
1次调用可能输出多张图片，根据输出图片张数进行计费，默认根据prompt理解意图判断输出图片数量
若对延迟&价格敏感，建议使用force_single参数，强制只输出1张图片
请求说明
名称
内容
接口地址
https://visual.volcengineapi.com
请求方式
POST
Content-Type
application/json
提交任务
提交任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，取值：CVSync2AsyncSubmitTask
Version
string
必选
版本号，取值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
名称
类型
必选
描述
req_key
string
必选
服务标识
取固定值: jimeng_t2i_v40
image_urls
array of string
可选
图片文件URL，支持输入0至10张图
图片数量越多&图片尺寸越大，整体服务处理时间越长
输入图片建议控制在6张图片以内，图片过多，参考效果会降低
prompt
string
必选
用于生成图像的提示词，中英文输入均可 。建议：
最长不超过800字符，prompt过长有概率出图异常或不生效
支持 prompt中直接指定生图比例，模型会根据“size”字段智能判断生图宽高比，默认生成2K分辨率、宽高比不超过3的图像；
除“”外不建议输入特殊的符号如$
size
int
可选
文生图场景
面积和宽高需要2选1传入，都不传则默认面积取“2048*2048”，即生成2K分辨率图像且模型智能判断宽高比；
面积和宽高同时输入时，优先使用宽高；
只传面积，模型会根据用户prompt意图智能判断生图宽高比
图生图场景：
结合用户prompt意图、参考图尺寸，由模型智能判断生图宽高比
生成图片的面积，默认值：4194304，即2048*2048，生成2K分辨率图像；
取值范围：[1024*1024, 4096*4096]，可生成1K到4K分辨率图像；
建议生成2k以上的图片，过小分辨率图片较大概率出现人脸效果不佳、文字异常等效果问题；若2K图片出图效果也不符合预期，可尝试输出更高分辨率图片
width
int
1、生成图像宽高，默认该字段不传；
2、宽高乘积在[1024*1024, 4096*4096]，且宽高比在[min_ratio, max_ratio]之间
注意：
需同时传width和height才会生效
推荐可选的宽高：
1K
1024x1024 （1:1）
2K
2048x2048 （1:1）
2304x1728（4:3）
2496x1664 （3:2）
2560x1440 （16:9）
3024x1296 （21:9）
4K
4096x4096 （1:1）
4694x3520（4:3）
4992x3328 （3:2）
5404x3040 （16:9）
6198x2656 （21:9）
height
int
scale
float
可选
文本描述影响的程度，该值越大代表文本描述影响程度越大，且输入图片影响程度越小（精度：支持小数点后两位）
默认值：0.5
取值范围：[0, 1]
force_single
bool
可选
是否强制生成单图
默认值：false
注意：
生成的组图越多，耗时越久，且生成耗时会随图片数量增多而显著变长；
如需稳定的组图输出效果，建议prompt控制组图数量在9张及以内；
生成组图时，建议prompt明确指明图片分辨率或直接传参具体宽高值，避免模型生成组图分辨率不一致导致接口报错；
min_ratio
float
可选
生图结果的宽/高 ≥ min_ratio，如果智能选比例 < min_ratio，则用min_ratio
默认值：1/3
取值范围：[1/16,16)
max_ratio
float
可选
生图结果的宽/高 ≤ max_ratio，如果智能选比例 > max_ratio，则用max_ratio
默认值：3
取值范围：[1/16,16)
提交任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
字段
类型
说明
task_id
string
任务ID，用于查询结果
提交任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v40",
"image_urls": [
"https://xxxx",
// ...
],
"prompt": "背景换成演唱会现场",
"seed": -1,
"scale": 0.5
}
返回示例：
{
"code": 10000,
"data": {
"task_id": "7392616336519610409"
},
"message": "Success",
"request_id": "20240720103939AF0029465CF6A74E51EC",
"status": 10000,
"time_elapsed": "104.852309ms"
}
查询任务
查询任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncGetResult&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，固定值：CVSync2AsyncGetResult
Version
string
必选
版本号，固定值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
说明
req_key
string
必选
服务标识
取固定值: jimeng_t2i_v40
task_id
string
必选
任务ID，此字段的取值为提交任务接口的返回
req_json
JSON string
可选
json序列化后的字符串
目前支持水印配置和是否以图片链接形式返回，可在返回结果中添加
示例："{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
ReqJson(序列化后的结果再赋值给req_json)
配置信息
参数
类型
可选/必选
说明
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表示完全不透明，默认1
logo_text_content
string
可选
明水印自定义内容
查询任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
说明
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
参数名
参数说明
参数示例
binary_data_base64
array of string
返回图片的base64数组。
image_urls
array of string
返回图片的url数组，输出图片格式为jpeg格式
status
string
任务执行状态
in_queue：任务已提交
generating：任务已被消费，处理中
done：处理完成，成功或者失败，可根据外层code&message进行判断
not_found：任务未找到，可能原因是无此任务或任务已过期(12小时)
expired：任务已过期，请尝试重新提交任务请求
查询任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v40",
"task_id": "<任务提交接口返回task_id>",
"req_json":"{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
}
返回示例：
{
"code": 10000,
"data": {
"binary_data_base64": null,
"image_urls": [
"https://xxxx",
// ...
],
"status": "done"
},
"message": "Success",
"request_id": "2025061718460554C9B78D23B0BAB45B2A",
"status": 10000,
"time_elapsed": "508.312154ms"
}
错误码
通用错误码
请参考通用返回字段及错误码
业务错误码
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
输入文本含敏感词、版权词等审核不通过
不需要
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使用说明
HTTP方式接入说明
请参考HTTP请求示例
即梦图生图3.0智能参考-接口文档
最近更新时间：2025.09.08 17:25:21
首次发布时间：2025.07.24 13:57:28
我的收藏
有用
无用
接口简介
图生图3.0智能参考是即梦同源的图生图能力，支持基于文本指令进行图像编辑。该能力在精准执行编辑指令和保持图像内容完整性（如人物特征及精细细节）方面实现显著提升，尤其在处理真实图像和海报图文设计场景表现卓越。推荐在海报等设计等场景中，在文本指令中加入「海报」「平面设计」等词，并用引号标出期望文字时，可显著提升文字响应效果，产出高质量编辑结果，有效满足用户改图需求。
接入说明
限制条件
名称
内容
输入图要求
图片格式：仅支持JPEG、PNG格式，建议使用JPEG格式；
图片文件大小：最大 4.7MB，图片分辨率：最大 4096 * 4096；
长边与短边比例在3以内，超出此比例或比例相对极端，会导致报错。
输出图说明
输出图范围在 [512, 1536] 内；
输出图详细宽高规则，参考下方width、height中参数描述
请求说明
名称
内容
接口地址
https://visual.volcengineapi.com
请求方式
POST
Content-Type
application/json
提交任务
提交任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，取值：CVSync2AsyncSubmitTask
Version
string
必选
版本号，取值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
名称
类型
必选
描述
req_key
string
必选
服务标识
取固定值: jimeng_i2i_v30
binary_data_base64
array of string
必选（二选一）
图片文件base64编码，需输入1张图片
image_urls
array of string
必选（二选一）
图片文件URL，需输入1张图片
prompt
string
必选
用于编辑图像的提示词 。建议：
建议长度<=120字符，最长不超过800字符，prompt过长有概率出图异常或不生效
如果图片应用于设计、营销等场景，可在prompt中加入“海报、平面设计”等词，模型会在该类场景有所增强。（例如，平面设计，一只小狗在马路上奔跑）
prompt 中用引号将希望书写的文字引起来，文字准确率会更高（例如：一张圣诞节卡片，上面写着“Merry Christmas”）
编辑指令使用自然语言即可
每次编辑使用单指令会更好
局部编辑时指令描述尽量精准，尤其是画面有多个实体的时候，描述清楚对谁做什么，能获取更精准的编辑效果
发现编辑效果不明显的时候，可以调整一下编辑强度scale，数值越大越贴近指令执行
尽量使用清晰的，分辨率高的底图，效果会更好。
参考示例：
添加/删除实体：添加/删除xxx（删除图上的女孩/添加一道彩虹）
修改实体：把xxx改成xxx（把手里的鸡腿变成汉堡）
修改风格：改成xxx风格（改成漫画风格）
修改色彩：把xxx改成xx颜色（把衣服改成粉色的）
修改动作：修改表情动作（让他哭/笑/生气）
修改环境背景：背景换成xxx，在xxx（背景换成海边/在星空下）
seed
int
可选
随机种子，作为确定扩散初始状态的基础，默认-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成内容极大概率效果一致
默认值：-1
scale
float
可选
文本描述影响的程度，该值越大代表文本描述影响程度越大，且输入图片影响程度越小
默认值：0.5
取值范围：[0, 1]
width
int
可选
1、生成图像宽高，系统默认生成1328 * 1328的图像；
2、支持自定义生成图像宽高，范围在[512, 2016]内；推荐可选的宽高比：
1328 * 1328（1:1）
1472 * 1104 （4:3）
1584 * 1056（3:2）
1664 * 936（16:9）
2016 * 864（21:9）
注意：
需同时传width和height才会生效；
如果自定义生图宽高都比1024小很多（如：600以下）可能出图全黑，建议优先设置接近1024的生图宽高；
最终输出图宽高与传入宽高相关但不完全相等，为“与传入宽高最接近16整数倍”的像素值，范围在 [512, 1536] 内；
height
int
可选
提交任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
字段
类型
说明
task_id
string
任务ID，用于查询结果
提交任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_i2i_v30",
// "binary_data_base64": [],
"image_urls": [
"https://xxxx"
],
"prompt": "背景换成演唱会现场",
"seed": -1,
"scale": 0.5
}
返回示例：
{
"code": 10000,
"data": {
"task_id": "7392616336519610409"
},
"message": "Success",
"request_id": "20240720103939AF0029465CF6A74E51EC",
"status": 10000,
"time_elapsed": "104.852309ms"
}
查询任务
查询任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncGetResult&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，固定值：CVSync2AsyncGetResult
Version
string
必选
版本号，固定值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
说明
req_key
string
必选
服务标识
取固定值: jimeng_i2i_v30
task_id
string
必选
任务ID，此字段的取值为提交任务接口的返回
req_json
JSON string
可选
json序列化后的字符串
目前支持水印配置和是否以图片链接形式返回，可在返回结果中添加
示例："{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
ReqJson(序列化后的结果再赋值给req_json)
配置信息
参数
类型
可选/必选
说明
return_url
bool
可选
输出是否返回图片链接 （链接有效期为24小时）
logo_info
LogoInfo
可选
水印信息
aigc_meta
AIGCMeta
可选
隐式标识
隐式标识验证方式：
查看【png】或【mp4】格式，人工智能生成合成内容表示服务平台（后续预计增加jpg）
https://www.gcmark.com/web/index.html#/mark/check/image
查看【jpg】格式，使用app11 segment查看aigc元数据内容
如 https://cyber.meme.tips/jpdump/#
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表示完全不透明，默认1
logo_text_content
string
可选
明水印自定义内容
AIGCMeta
隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》
名称
类型
可选/必选
描述
content_producer
string
可选
内容生成服务ID
producer_id
string
可选
内容生成服务商给此图片数据的唯一ID
content_propagator
string
可选
内容传播服务商ID
propagate_id
string
可选
传播服务商给此图片数据的唯一ID
查询任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
说明
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
参数名
参数说明
参数示例
binary_data_base64
array of string
返回图片的base64数组。
image_urls
array of string
返回图片的url数组，输出图片格式为jpeg格式
status
string
任务执行状态
in_queue：任务已提交
generating：任务已被消费，处理中
done：处理完成，成功或者失败，可根据外层code&message进行判断
not_found：任务未找到，可能原因是无此任务或任务已过期(12小时)
expired：任务已过期，请尝试重新提交任务请求
查询任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_i2i_v30",
"task_id": "<任务提交接口返回task_id>",
"req_json": "{\"logo_info\":{\"add_logo\":false,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true,\"aigc_meta\":{\"content_producer\":\"xxx\",\"producer_id\":\"xxx\",\"logo_text_content\":\"xxx\",\"logo_text_content\":\"xxx\"}}"
}
返回示例：
{
"code": 10000,
"data": {
"binary_data_base64": null,
"image_urls": [
"https://xxxx"
],
"status": "done"
},
"message": "Success",
"request_id": "2025061718460554C9B78D23B0BAB45B2A",
"status": 10000,
"time_elapsed": "508.312154ms"
}
错误码
通用错误码
请参考通用返回字段及错误码
业务错误码
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
输入文本含敏感词、版权词等审核不通过
不需要
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使用说明
HTTP方式接入说明
请参考HTTP请求示例
即梦文生图3.1-接口文档
最近更新时间：2025.09.08 17:25:03
首次发布时间：2025.07.28 14:50:30
我的收藏
有用
无用
接口简介
文生图3.1是与即梦同源的文生图能力，该版本重点实现画面效果呈现升级，在画面美感塑造、风格精准多样及画面细节丰富度方面提升显著，同时兼具文字响应效果。
接入说明
请求说明
名称
内容
接口地址
https://visual.volcengineapi.com
请求方式
POST
Content-Type
application/json
提交任务
提交任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，取值：CVSync2AsyncSubmitTask
Version
string
必选
版本号，取值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
描述
req_key
string
必选
算法名称，取固定值为jimeng_t2i_v31
prompt
string
必选
用于生成图像的提示词 ，中英文均可输入。建议长度<=120字符，最长不超过800字符，prompt过长有概率出图异常或不生效
use_pre_llm
bool
可选
开启文本扩写，会针对输入prompt进行扩写优化，如果输入prompt较短建议开启，如果输入prompt较长建议关闭
默认值：true
seed
int
可选
随机种子，作为确定扩散初始状态的基础，默认-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致
默认值：-1
width
int
可选
1、生成图像宽高，系统默认生成1328 * 1328的图像；
2、支持自定义生成图像宽高，宽高比在1:3到3:1之间，长度在[512, 2048]之间；推荐可选的宽高比为：
标清1K
1328 * 1328（1:1）
1472 * 1104 （4:3）
1584 * 1056（3:2）
1664 * 936（16:9）
2016 * 864（21:9）
高清2K
2048 * 2048（1:1）
2304 * 1728 （4:3）
2496 * 1664（3:2）
2560 * 1440（16:9）
3024 * 1296（21:9）
注意：
需同时传width和height才会生效；
height
int
可选
提交任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
字段
类型
说明
task_id
string
任务ID，用于查询结果
提交任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v31",
"prompt": "千军万马",
"seed": -1,
"width": 1024,
"height": 1024
}
返回示例：
{
"code": 10000,
"data": {
"task_id": "7392616336519610409"
},
"message": "Success",
"request_id": "20240720103939AF0029465CF6A74E51EC",
"status": 10000,
"time_elapsed": "104.852309ms"
}
查询任务
查询任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncGetResult&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，固定值：CVSync2AsyncGetResult
Version
string
必选
版本号，固定值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
说明
req_key
string
必选
服务标识
取固定值: jimeng_t2i_v31
task_id
string
必选
任务ID，此字段的取值为提交任务接口的返回
req_json
JSON string
可选
json序列化后的字符串
目前支持水印配置和是否以图片链接形式返回，可在返回结果中添加
示例："{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
ReqJson(序列化后的结果再赋值给req_json)
配置信息
参数
类型
可选/必选
说明
return_url
bool
可选
输出是否返回图片链接 （链接有效期为24小时）
logo_info
LogoInfo
可选
水印信息
aigc_meta
AIGCMeta
可选
隐式标识
隐式标识验证方式：
查看【png】或【mp4】格式，人工智能生成合成内容表示服务平台（后续预计增加jpg）
https://www.gcmark.com/web/index.html#/mark/check/image
查看【jpg】格式，使用app11 segment查看aigc元数据内容
如 https://cyber.meme.tips/jpdump/#
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表示完全不透明，默认1
logo_text_content
string
可选
明水印自定义内容
AIGCMeta
隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》
名称
类型
可选/必选
描述
content_producer
string
可选
内容生成服务ID
producer_id
string
可选
内容生成服务商给此图片数据的唯一ID
content_propagator
string
可选
内容传播服务商ID
propagate_id
string
可选
传播服务商给此图片数据的唯一ID
查询任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
说明
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
参数名
参数说明
参数示例
binary_data_base64
array of string
返回图片的base64数组。
image_urls
array of string
返回图片的url数组，输出图片格式为png格式
status
string
任务执行状态
in_queue：任务已提交
generating：任务已被消费，处理中
done：处理完成，成功或者失败，可根据外层code&message进行判断
not_found：任务未找到，可能原因是无此任务或任务已过期(12小时)
expired：任务已过期，请尝试重新提交任务请求
查询任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v31",
"task_id": "<任务提交接口返回task_id>",
"req_json": "{\"logo_info\":{\"add_logo\":false,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true,\"aigc_meta\":{\"content_producer\":\"xxx\",\"producer_id\":\"xxx\",\"logo_text_content\":\"xxx\",\"logo_text_content\":\"xxx\"}}"
}
返回示例：
{
"code": 10000,
"data": {
"binary_data_base64": null,
"image_urls": [
"https://xxxx"
],
"status": "done"
},
"message": "Success",
"request_id": "2025061718460554C9B78D23B0BAB45B2A",
"status": 10000,
"time_elapsed": "508.312154ms"
}
错误码
通用错误码
请参考通用返回字段及错误码
业务错误码
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
输入文本含敏感词、版权词等审核不通过
不需要
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使用说明
HTTP方式接入说明
请参考HTTP请求示例
即梦文生图3.0-接口文档
最近更新时间：2025.09.08 17:24:37
首次发布时间：2025.07.02 17:30:46
我的收藏
有用
无用
接口简介
文生图3.0是即梦同源的文生图能力，在文字响应准确度、图文排版、层次美感和语义理解能力上相较之前版本均有显著提升，人像质感更逼真，且支持输出高清大图。此外，在文字响应更精准的基础下，还支持响应大小字、各类艺术字体和不同字重。
接入说明
请求说明
名称
内容
接口地址
https://visual.volcengineapi.com
请求方式
POST
Content-Type
application/json
提交任务
提交任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncSubmitTask&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，取值：CVSync2AsyncSubmitTask
Version
string
必选
版本号，取值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
说明
req_key
string
必选
算法名称，取固定值为jimeng_t2i_v30
prompt
string
必选
用于生成图像的提示词 ，中英文均可输入。建议长度<=120字符，最长不超过800字符，prompt过长有概率出图异常或不生效
use_pre_llm
bool
可选
开启文本扩写，会针对输入prompt进行扩写优化，如果输入prompt较短建议开启，如果输入prompt较长建议关闭
默认值：true
seed
int
可选
随机种子，作为确定扩散初始状态的基础，默认-1（随机）。若随机种子为相同正整数且其他参数均一致，则生成图片极大概率效果一致
默认值：-1
width
int
可选
1、生成图像宽高，系统默认生成1328 * 1328的图像；
2、支持自定义生成图像宽高，宽高比在1:3到3:1之间，长度在[512, 2048]之间；推荐可选的宽高比为：
标清1K
1328 * 1328（1:1）
1472 * 1104 （4:3）
1584 * 1056（3:2）
1664 * 936（16:9）
2016 * 864（21:9）
高清2K
2048 * 2048（1:1）
2304 * 1728 （4:3）
2496 * 1664（3:2）
2560 * 1440（16:9）
3024 * 1296（21:9）
注意：
需同时传width和height才会生效；
height
int
可选
提交任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
字段
类型
说明
task_id
string
任务ID，用于查询结果
提交任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v30",
"prompt": "千军万马",
"seed": -1,
"width": 1024,
"height": 1024
}
返回示例：
{
"code": 10000,
"data": {
"task_id": "7392616336519610409"
},
"message": "Success",
"request_id": "20240720103939AF0029465CF6A74E51EC",
"status": 10000,
"time_elapsed": "104.852309ms"
}
查询任务
查询任务请求参数
Query参数
拼接到url后的参数，示例：https://visual.volcengineapi.com?Action=CVSync2AsyncGetResult&Version=2022-08-31
参数
类型
可选/必选
说明
Action
string
必选
接口名，固定值：CVSync2AsyncGetResult
Version
string
必选
版本号，固定值：2022-08-31
Header参数
注意
本服务固定值：Region为cn-north-1，Service为cv
主要用于鉴权，详见 公共参数 - 签名参数 - 在Header中的场景部分
Body参数
注意
业务请求参数，放到request.body中，MIME-Type为application/json
参数
类型
可选/必选
说明
req_key
string
必选
服务标识
取固定值: jimeng_t2i_v30
task_id
string
必选
任务ID，此字段的取值为提交任务接口的返回
req_json
JSON string
可选
json序列化后的字符串
目前支持水印配置和是否以图片链接形式返回，可在返回结果中添加
示例："{\"logo_info\":{\"add_logo\":true,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true}"
ReqJson(序列化后的结果再赋值给req_json)
配置信息
参数
类型
可选/必选
说明
return_url
bool
可选
输出是否返回图片链接 （链接有效期为24小时）
logo_info
LogoInfo
可选
水印信息
aigc_meta
AIGCMeta
可选
隐式标识
隐式标识验证方式：
查看【png】或【mp4】格式，人工智能生成合成内容表示服务平台（后续预计增加jpg）
https://www.gcmark.com/web/index.html#/mark/check/image
查看【jpg】格式，使用app11 segment查看aigc元数据内容
如 https://cyber.meme.tips/jpdump/#
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表示完全不透明，默认1
logo_text_content
string
可选
明水印自定义内容
AIGCMeta
隐式标识，依据《人工智能生成合成内容标识办法》&《网络安全技术人工智能生成合成内容标识方法》
名称
类型
可选/必选
描述
content_producer
string
可选
内容生成服务ID
producer_id
string
可选
内容生成服务商给此图片数据的唯一ID
content_propagator
string
可选
内容传播服务商ID
propagate_id
string
可选
传播服务商给此图片数据的唯一ID
查询任务返回参数
通用返回参数
请参考通用返回字段及错误码
业务返回参数
说明
重点关注data中以下字段，其他字段为公共返回(可忽略或不做解析)
参数名
参数说明
参数示例
binary_data_base64
array of string
返回图片的base64数组。
image_urls
array of string
返回图片的url数组，输出图片格式为jpeg格式
status
string
任务执行状态
in_queue：任务已提交
generating：任务已被消费，处理中
done：处理完成，成功或者失败，可根据外层code&message进行判断
not_found：任务未找到，可能原因是无此任务或任务已过期(12小时)
expired：任务已过期，请尝试重新提交任务请求
查询任务请求&返回完整示例
请求示例：
{
"req_key": "jimeng_t2i_v30",
"task_id": "<任务提交接口返回task_id>",
"req_json": "{\"logo_info\":{\"add_logo\":false,\"position\":0,\"language\":0,\"opacity\":1,\"logo_text_content\":\"这里是明水印内容\"},\"return_url\":true,\"aigc_meta\":{\"content_producer\":\"xxx\",\"producer_id\":\"xxx\",\"logo_text_content\":\"xxx\",\"logo_text_content\":\"xxx\"}}"
}
返回示例：
{
"code": 10000,
"data": {
"binary_data_base64": null,
"image_urls": [
"https://xxxx"
],
"status": "done"
},
"message": "Success",
"request_id": "2025061718460554C9B78D23B0BAB45B2A",
"status": 10000,
"time_elapsed": "508.312154ms"
}
错误码
通用错误码
请参考通用返回字段及错误码
业务错误码
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
输入文本含敏感词、版权词等审核不通过
不需要
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使用说明
HTTP方式接入说明
请参考HTTP请求示例
