即梦图片生成示例
以下示例展示如何使用即梦(Jimeng)API 生成高质量的图片。即梦是火山引擎旗下的AI绘画产品,支持文生图和图生图功能。
快速开始
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API-KEY>" \
-d '{
"prompt": "一只可爱的小猫在花园里玩耍,阳光明媚,油画风格",
"model": "jimeng-3.0-t2i",
"size": "1328x1328",
"response_format": "url",
"watermark": true
}'
图生图示例
即梦支持基于现有图片生成新图片的功能(图生图),通过 /v1/images/edits 接口实现:
curl -X POST "https://api.tokenops.ai/v1/images/edits" \
-H "Authorization: Bearer <API-KEY>" \
-F "prompt=将图片改为水彩画风格" \
-F "model=jimeng-3.0-i2i" \
-F "size=1328x1328" \
-F "image=@/path/to/your/image.png"
支持的参数
文生图参数(/v1/images/generations)
| 参数 | 类型 | 必需 | 说明 |
|---|
| prompt | string | 是 | 图片描述文本 |
| model | string | 是 | 模型名称,如 jimeng-3.0-t2i |
| size | string | 否 | 图片尺寸,默认 1328x1328,详见下方尺寸说明 |
| response_format | string | 否 | 返回格式(url 或 b64_json),默认 url |
| seed | integer | 否 | 随机数种子,-1表示随机 |
| watermark | boolean | 否 | 是否添加水印,默认 true |
| optimize_prompt_options | object | 否 | 提示词优化配置,{"enable": true/false} |
图片尺寸说明
即梦支持自定义生成图像宽高,要求:
- 宽高比在 1:3 到 3:1 之间
- 宽高乘积在 512×512 到 2048×2048 之间
- 默认生成 1328×1328 的图像
推荐尺寸:
| 分辨率 | 标清 1K | 高清 2K |
|---|
| 1:1 | 1328×1328 | 2048×2048 |
| 4:3 | 1472×1104 | 2304×1728 |
| 3:2 | 1584×1056 | 2496×1664 |
| 16:9 | 1664×936 | 2560×1440 |
| 21:9 | 2016×864 | 3024×1296 |
竖版图片可交换宽高值,如 1:1 比例的 1328×1328,4:3 比例的竖版为 1104×1472。
图生图参数(/v1/images/edits)
| 参数 | 类型 | 必需 | 说明 |
|---|
| prompt | string | 是 | 生成描述文本 |
| model | string | 是 | 模型名称,如 jimeng-3.0-i2i |
| image | file/string | 是 | 输入图片(文件或URL) |
| size | string | 否 | 输出图片尺寸,默认 1328x1328,详见上方尺寸说明 |
| seed | integer | 否 | 随机数种子,-1表示随机 |
响应格式
文生图响应
{
"created": 1762841059,
"data": [
{
"url": "https://xxx.com/images/xxx.png"
}
],
"generate_image": 1
}
图生图响应
{
"created": 1762841059,
"data": [
{
"url": "https://xxx.com/images/xxx.png"
}
],
"generate_image": 1
}
重要提示
即梦API特性说明:
- 即梦使用异步任务机制,提交任务后会轮询获取结果
- 图片生成时间可能较长(通常10-60秒),请耐心等待
- 生成的图片URL有效期为3天
提示词扩写功能:
- 即梦支持提示词扩写功能(use_pre_llm),默认开启
- 通过
optimize_prompt_options.enable 参数可控制是否启用
- 开启后会自动优化用户输入的提示词,生成更好的图片