文生图

文生图是指根据输入的文本描述（prompt）智能生成相关图像的能力。提示词描述越完整、精确和丰富，生成的图片越贴近期望内容。

支持的模型

模型名称	最大分辨率	特点
doubao-seedream-5-0-260128	4096x4096	支持组图生成、多图融合、联网搜索
doubao-seedream-5-0-pro-260628	2048x2048	生成精度高，支持交互编辑、图层拆分

请求参数

参数名称	参数解释	必填	参数类型
model	模型名称	是	String
prompt	文本描述，建议详细描述画面主体、细节、场景等	是	String
size	图片分辨率，支持分辨率档位或 宽x高 像素值	否	String
response_format	返回格式，url 或 b64_json	否	String
watermark	是否添加水印	否	Boolean

prompt 编写指南

提示词是生成图片的关键，一个好的提示词通常包含以下元素：

1. 主体描述：明确画面中的主要对象
2. 细节特征：颜色、材质、纹理等
3. 场景环境：时间、地点、氛围
4. 风格指定：艺术风格、摄影风格等
5. 构图视角：视角、焦距、景深等

示例：

一只可爱的小猫在花园里玩耍，阳光明媚，色彩鲜艳，水彩画风格

size 可选值

支持两种方式，二者不可混用：

方式一：分辨率档位（推荐），在 prompt 中用自然语言描述图片宽高比、形状或用途，由模型决定具体尺寸。

模型	可选档位	默认值
doubao-seedream-5-0-260128	2K、3K、4K	2K
doubao-seedream-5-0-pro-260628	1K、1.5K、2K	2K

方式二：指定宽高像素值（格式 宽x高），需同时满足总像素范围和宽高比 [1/16, 16] 的要求。

模型	总像素范围	默认值
doubao-seedream-5-0-260128	[2560x1440, 4096x4096]	2048x2048
doubao-seedream-5-0-pro-260628	[1280x720, 2048x2048×1.1025]	2K

常用参考像素值（doubao-seedream-5-0-260128）：

档位	1:1	16:9	9:16	4:3	3:4
2K	2048x2048	2848x1600	1600x2848	2304x1728	1728x2304
4K	4096x4096	5504x3040	3040x5504	4704x3520	3520x4704

doubao-seedream-5-0-pro-260628 各档位映射的像素值略有差异，以豆包官方文档说明为准。

示例代码

使用 doubao-seedream-5-0-260128

curl -X POST https://api-ai.xku.com/doubao/api/v3/images/generations \
  -H "Authorization: Bearer XKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "雨中的竹林，一条小路蜿蜒穿过，雾气缭绕，清新自然",
    "size": "2K",
    "watermark": false
  }'

使用 doubao-seedream-5-0-pro-260628（高精度）

curl -X POST https://api-ai.xku.com/doubao/api/v3/images/generations \
  -H "Authorization: Bearer XKU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "一幅精美的风景油画，山间溪流，远处有雪山，云雾缭绕，阳光穿透云层洒在水面上",
    "size": "2K",
    "watermark": false
  }'

返回示例

{
    "model": "doubao-seedream-5-0-260128",
    "created": 1757321139,
    "data": [
        {
            "url": "https://api-ai.xku.com/images/xxx.jpg",
            "size": "2048x2048"
        }
    ],
    "usage": {
        "generated_images": 1
    }
}

注意事项

1. 提示词建议不超过 300 个汉字或 600 个英文单词
2. 生成的图片链接 24 小时内有效，请及时保存