即梦生图参数详解

概述

JiMeng 图像生成 API 支持多种图像生成模式，包括文生图和图生图功能。

接口信息

请求地址： POST /v1/tasks/generations

内容类型： application/json

认证方式： Bearer Token

请求头示例：

功能概览

功能类型	任务类型识别条件	描述
文生图 (Text-to-Image)	仅包含 `prompt` 参数	根据文本描述生成图片
图生图 (Image-to-Image)	包含图片参数 + `prompt`	基于图片编辑生成新图片

任务类型自动识别

系统根据以下优先级自动识别任务类型：

图生图：如果包含 binary_data_base64 或 image_urls 参数，识别为图生图任务

文生图：默认情况，识别为文生图任务

响应结构

基础响应结构

字段名	类型	必填	描述	示例值
`code`	string	是	响应状态码，"success" 表示成功	`"success"`
`message`	string	是	响应消息，通常为空字符串	`""`
`data`	object	是	任务详细信息对象	-

任务信息字段 (data)

字段名	类型	必填	描述	示例值
`request_id`	string	是	请求的唯一标识符，用于后续查询任务状态	`"202508291629159482180006i9T0vui"`
`task_id`	string	是	任务 ID，系统内部生成的任务标识符	`""`
`action`	string	是	任务类型，固定为 "IMAGE_GENERATION"	`"IMAGE_GENERATION"`
`status`	string	是	任务状态，提交时通常为 "SUBMITTING"	`"SUBMITTING"`
`fail_reason`	string	是	失败原因，任务成功时为空	`""`
`submit_time`	number	是	任务提交时间戳（Unix 时间戳，秒）	`1756456156`
`start_time`	number	是	任务开始处理时间戳（Unix 时间戳，秒）	`0`
`finish_time`	number	是	任务完成时间戳（Unix 时间戳，秒），未完成时为 0	`0`
`progress`	string	是	任务进度百分比	`"0%"`
`data`	object	是	任务结果数据对象，提交时通常为空	`{}`

标准响应示例

任务提交成功响应

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "20250829203041325320000CFVslBwb",
    "task_id": "",
    "action": "IMAGE_GENERATION",
    "status": "SUBMITTING",
    "fail_reason": "",
    "submit_time": 1756470641,
    "start_time": 0,
    "finish_time": 0,
    "progress": "0%",
    "data": {}
  }
}

提交失败响应

{
  "code": "invalid_request",
  "message": "prompt is required",
  "data": null
}

文生图 (Text-to-Image)

概述

根据文本提示词生成高质量的图像内容，支持多种风格和场景的图像创作。

任务类型识别

当请求参数中仅包含文本提示词，不包含图片相关参数时，系统自动识别为文生图任务。

请求参数

参数名	类型	必填	默认值	描述	示例值
`model`	string	是	-	模型名称	`"bytedance/jimeng_t2i_v30"`
`prompt`	string	是	-	文本提示词，中英文均可，建议 ≤ 120 字符，最大 800 字符	`"一只可爱的小猫坐在花园里"`
`use_pre_llm`	bool	否	true	开启文本扩写，针对输入 prompt 进行扩写优化	`true`
`seed`	int	否	-1	随机种子，默认 -1（随机），使用固定值可复现相同结果	`12345`
`width`	int	否	1328	生成图像宽度，需与 height 同时传入才生效	`1664`
`height`	int	否	1328	生成图像高度，需与 width 同时传入才生效	`936`

参数详细说明

参数	可选值	默认值	说明
`use_pre_llm`	`true`, `false`	`true`	建议短 prompt 开启，长 prompt 关闭
`seed`	-1 或正整数	`-1`	-1 表示随机生成，使用固定正整数可以复现相同的生成结果
`width`	512-2048 (16的倍数)	`1328`	图像宽度，必须与 height 同时设置
`height`	512-2048 (16的倍数)	`1328`	图像高度，必须与 width 同时设置

尺寸配置

宽高比	尺寸	适用场景
1:1	1328 × 1328	头像、图标
4:3	1472 × 1104	传统照片
3:2	1584 × 1056	摄影作品
16:9	1664 × 936	横屏壁纸
21:9	2016 × 864	超宽屏壁纸

宽高比	尺寸	适用场景
1:1	2048 × 2048	高清头像
4:3	2304 × 1728	高清照片
3:2	2496 × 1664	专业摄影
16:9	2560 × 1440	2K 壁纸
21:9	3024 × 1296	超宽屏高清

尺寸约束

约束项	要求	说明
宽高比	1:3 到 3:1 之间	过于极端的宽高比可能影响生成质量
尺寸范围	[512, 2048] 像素	超出范围可能导致生成失败
像素对齐	必须是 16 的倍数	系统会自动调整为最接近的 16 整数倍
同时设置	width 和 height 必须同时传入	单独设置其中一个参数不会生效

请求示例

基础文生图

{
  "model": "bytedance/jimeng_t2i_v30",
  "prompt": "一只可爱的小猫坐在花园里，阳光明媚，画面温馨",
  "use_pre_llm": true,
  "seed": -1,
  "width": 1664,
  "height": 936
}

高清图像生成

{
  "model": "bytedance/jimeng_t2i_v30",
  "prompt": "壮观的山脉日出景色，云海翻腾，金光万丈",
  "use_pre_llm": true,
  "width": 2560,
  "height": 1440,
}

固定种子复现

{
  "model": "bytedance/jimeng_t2i_v30",
  "prompt": "现代简约风格的室内设计，客厅，北欧风",
  "use_pre_llm": false,
  "seed": 42,
  "width": 1472,
  "height": 1104
}

方形头像生成

{
  "model": "bytedance/jimeng_t2i_v30",
  "prompt": "卡通风格的可爱女孩头像，大眼睛，微笑",
  "use_pre_llm": true,
  "width": 1328,
  "height": 1328
}

图生图 (Image-to-Image)

请求参数

参数名	类型	必填	默认值	描述
`model`	string	是	-	模型名称，映射到上游 `req_key`：`jimeng_i2i_v30`
`binary_data_base64`	string[]	二选一必填	-	图片文件 base64 编码，需输入 1 张图片
`image_urls`	string[]	二选一必填	-	图片文件 URL，需输入 1 张图片
`prompt`	string	是	-	编辑图像的提示词，建议 ≤ 120 字符，最大 800 字符
`seed`	int	否	-1	随机种子，默认 -1（随机）
`scale`	float	否	0.5	文本描述影响程度，值越大文本影响越大，图片影响越小
`width`	int	否	1328	生成图像宽度，需与 height 同时传入才生效
`height`	int	否	1328	生成图像高度，需与 width 同时传入才生效

图片约束

需输入 1 张图片

支持 JPEG、PNG 格式

图片大小 ≤ 4.7MB

分辨率：最长边 ≤ 4096，最短边 ≥ 320

长边与短边比例在 3 以内

宽高约束

范围在 [512, 2016] 内

需同时传 width 和 height 才会生效

如果自定义生图宽高都比 1024 小很多（如：600 以下）可能出图全黑

最终输出图宽高与传入宽高相关但不完全相等，为"与传入宽高最接近 16 整数倍"的像素值，范围在 [512, 1536] 内

编辑指令建议

场景增强：

如果图片应用于设计、营销等场景，可在 prompt 中加入"海报、平面设计"等词

例如："平面设计，一只小狗在马路上奔跑"

文字书写：

用引号将希望书写的文字引起来，文字准确率会更高

例如："一张圣诞节卡片，上面写着'Merry Christmas'"

编辑类型示例：

添加/删除实体："添加/删除xxx"（删除图上的女孩/添加一道彩虹）

修改实体："把xxx改成xxx"（把手里的鸡腿变成汉堡）

修改风格："改成xxx风格"（改成漫画风格）

修改色彩："把xxx改成xx颜色"（把衣服改成粉色的）

修改动作："修改表情动作"（让他哭/笑/生气）

修改环境背景："背景换成xxx，在xxx"（背景换成海边/在星空下）

请求示例

基础图生图

{
  "model": "bytedance/jimeng_i2i_v30",
  "image_urls": ["https://example.com/input.jpg"],
  "prompt": "把衣服改成粉色的，背景换成海边",
  "seed": -1,
  "scale": 0.7,
  "width": 1664,
  "height": 936
}

使用 Base64 图片

{
  "model": "bytedance/jimeng_i2i_v30",
  "binary_data_base64": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
  ],
  "prompt": "改成漫画风格，添加一道彩虹",
  "scale": 0.8,
  "width": 1328,
  "height": 1328
}

文字编辑示例

{
  "model": "bytedance/jimeng_i2i_v30",
  "image_urls": ["https://example.com/card.jpg"],
  "prompt": "一张生日卡片，上面写着'Happy Birthday'",
  "scale": 0.6,
  "width": 1472,
  "height": 1104
}

设计场景示例

{
  "model": "bytedance/jimeng_i2i_v30",
  "image_urls": ["https://example.com/product.jpg"],
  "prompt": "海报设计，产品展示，现代简约风格",
  "scale": 0.9,
  "width": 1664,
  "height": 936
}

概述

接口信息

功能概览

任务类型自动识别

响应结构

基础响应结构

任务信息字段 (data)

标准响应示例

任务提交成功响应

提交失败响应

文生图 (Text-to-Image)

概述

任务类型识别

请求参数

参数详细说明

尺寸配置

推荐宽高比配置

尺寸约束

请求示例

基础文生图

高清图像生成

固定种子复现

方形头像生成

图生图 (Image-to-Image)

请求参数

图片约束

宽高约束

推荐宽高比配置

编辑指令建议

请求示例

基础图生图

使用 Base64 图片

文字编辑示例

设计场景示例

即梦生图参数详解

概述#

接口信息#

功能概览#

任务类型自动识别#

响应结构#

基础响应结构#

任务信息字段 (data)#

标准响应示例#

任务提交成功响应#

提交失败响应#

文生图 (Text-to-Image)#

概述#

任务类型识别#

请求参数#

参数详细说明#

尺寸配置#

推荐宽高比配置#

尺寸约束#

请求示例#

基础文生图#

高清图像生成#

固定种子复现#

方形头像生成#

图生图 (Image-to-Image)#

请求参数#

图片约束#

宽高约束#

推荐宽高比配置#

编辑指令建议#

请求示例#

基础图生图#

使用 Base64 图片#

文字编辑示例#

设计场景示例#

概述

接口信息

功能概览

任务类型自动识别

响应结构

基础响应结构

任务信息字段 (data)

标准响应示例

任务提交成功响应

提交失败响应

文生图 (Text-to-Image)

概述

任务类型识别

请求参数

参数详细说明

尺寸配置

推荐宽高比配置

尺寸约束

请求示例

基础文生图

高清图像生成

固定种子复现

方形头像生成

图生图 (Image-to-Image)

请求参数

图片约束

宽高约束

推荐宽高比配置

编辑指令建议

请求示例

基础图生图

使用 Base64 图片

文字编辑示例

设计场景示例