Skip to main content

​
豆包图片生成示例

以下示例展示如何使用豆包 API 生成高质量的图片。

​
快速开始

curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚，油画风格",
    "model": "doubao-seedream-4-0-250828",
    "size": "1024x1024",
    "response_format": "url",
    "watermark": true
  }'

​
Seedream 5.0 lite 新特性

Seedream 5.0 lite（doubao-seedream-5-0-260128）相比 4.0 版本新增了以下能力：

​
指定输出格式（output_format）

5.0 lite 支持 png 和 jpeg 两种输出格式（4.0/4.5 仅支持 jpeg）。 
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "一只可爱的小猫在花园里玩耍，阳光明媚",
    "model": "doubao-seedream-5-0-260128",
    "size": "2048x2048",
    "output_format": "png",
    "response_format": "url"
  }'

​
联网搜索（web_search）

5.0 lite 支持联网搜索工具，模型会根据提示词自主判断是否需要搜索互联网内容，提升生成图片的时效性。通过 tools 参数开启。 
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "上海今日天气预报，天气可视化信息图",
    "model": "doubao-seedream-5-0-260128",
    "size": "2048x2048",
    "tools": [{"type": "web_search"}],
    "response_format": "url"
  }'
联网搜索说明：
  • 开启后模型会根据提示词自主判断是否需要搜索，不一定每次都会触发
  • 实际搜索次数可通过响应中的 usage.tool_usage.web_search 字段查看
  • 联网搜索会增加一定的响应时延
  • 仅 Seedream 5.0 lite 支持，4.0/4.5 不支持

​
重要提示

doubao-seedream-4-0-250828 模型参数限制：
  • guidance_scale 参数不支持，传入会报错
  • seed 参数可以传入但不生效，无法重现相同结果
多图片参数说明：
  • image 参数支持单个字符串URL或字符串URL数组格式
  • JSON数组会被正确解析和处理，无需担心类型转换问题
  • 不同功能需要使用对应的模型（详见各功能示例）

​
支持的模型

模型Model ID分辨率输出格式联网搜索
Seedream 5.0 litedoubao-seedream-5-0-2601282K, 3Kpng, jpeg支持
Seedream 4.5doubao-seedream-4-5-2511282K, 4Kjpeg不支持
Seedream 4.0doubao-seedream-4-0-2508281K, 2K, 4Kjpeg不支持

​
支持的分辨率

size 参数支持两种设置方式（不可混用）： 方式 1：分辨率等级（如 "2K"、"3K"），由模型根据提示词决定宽高比。 方式 2：精确像素值（如 "2048x2048"），推荐值如下：

​
Seedream 5.0 lite

2K 分辨率：
宽高比像素
1:12048x2048
3:41728x2304
4:32304x1728
16:92848x1600
9:161600x2848
3:22496x1664
2:31664x2496
21:93136x1344
3K 分辨率：
宽高比像素
1:13072x3072
3:42592x3456
4:33456x2592
16:94096x2304
9:162304x4096
2:32496x3744
3:23744x2496
21:94704x2016

​
支持的参数

​
基础参数

  • prompt: 图片描述文本（必需），建议不超过 300 汉字或 600 英文单词
  • model: 模型名称
  • size: 图片尺寸，分辨率等级（"2K"、"3K"）或精确像素值（"2048x2048"）
  • response_format: 返回格式（url 或 b64_json）
  • output_format: 输出图片格式（png 或 jpeg），仅 5.0 lite 支持 png
  • seed: 随机数种子，-1 表示随机

​
画质控制参数

  • watermark: 是否添加水印，默认 true

​
高级功能参数

  • stream: 是否启用流式输出，默认 false
  • tools: 工具列表，如 [{"type": "web_search"}] 开启联网搜索（仅 5.0 lite）
  • sequential_image_generation: 组图功能控制（auto 或 disabled）
  • sequential_image_generation_options: 组图功能配置
    • max_images: 最大图片数量
  • optimize_prompt_options: 提示词优化配置
    • mode: 优化模式（standard）
  • image: 基础图片，支持 URL 或 Base64 编码（用于图片编辑），最多 14 张

​
图片到图片生成示例

豆包还支持基于现有图片生成新图片的功能，通过 image 参数提供参考图片URL： 
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "生成狗狗趴在草地上的近景画面",
    "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imageToimage.png",
    "model": "doubao-seedream-4-0-250828",
    "size": "1024x1024",
    "response_format": "url",
    "watermark": true
  }'

​
多图融合生成示例

豆包还支持多张图片融合生成，可以将多张参考图片的元素组合到一张新图片中： 
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "将图1的服装换为图2的服装",
    "image": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_1.png",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimage_2.png"
    ],
    "sequential_image_generation": "disabled",
    "size": "1024x1024",
    "response_format": "url",
    "watermark": true
  }'

​
多图融合功能说明

  • 支持模型: doubao-seedream-4-0-250828（专门支持多图融合）
  • 输入格式: image 参数接受图片URL数组，最多支持多张图片
  • 提示词格式: 可使用”图1”、“图2”等引用不同的输入图片
  • 常见用途: 服装替换、风格迁移、元素组合、场景融合
  • 控制参数: sequential_image_generation 设为 "disabled" 以启用融合模式

​
图生组图示例

基于多张参考图片生成一组相关图片，适用于需要生成多个相关场景的情况： 
curl -X POST "https://api.tokenops.ai/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <API-KEY>" \
  -d '{
    "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
    "image": [
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png",
      "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
    ],
    "model": "doubao-seedream-4-0-250828",
    "sequential_image_generation": "auto",
    "sequential_image_generation_options": {
      "max_images": 3
    },
    "size": "1024x1024",
    "response_format": "url",
    "watermark": true
  }'

​
图生组图功能说明

  • 支持模型: doubao-seedream-4-0-250828
  • 组图模式: sequential_image_generation 设为 "auto" 启用自动组图生成
  • 数量控制: 通过 max_images 参数控制生成图片数量（建议1-10张）
  • 场景描述: 提示词可以描述多个场景变化，如时间、天气、角度等
  • 常见用途: 故事板生成、时间序列图片、多角度展示、场景变化演示
  • 输出特点: 生成的多张图片保持风格一致性，同时体现描述中的变化

​
响应格式

{
  "created": 1762841059,
  "data": [
    {
      "url": "xxxxxx"
    }
  ],
  "usage": {
    "total_tokens": 4096,
    "output_tokens": 4096,
    "input_tokens_details": {}
  }
}

​
应用场景

​
创意设计

  • 广告海报: 商业宣传图片生成
  • 产品包装: 包装设计概念图
  • UI界面: 应用图标和界面元素

​
内容创作

  • 社交媒体: 配图和封面设计
  • 博客文章: 文章插图和头图
  • 视频缩略图: 吸引眼球的封面图

​
艺术创作

  • 数字艺术: 各种风格的艺术作品
  • 概念设计: 游戏和影视概念图
  • 插画绘本: 故事插图和角色设计

​
最佳实践

​
提示词优化

# 好的提示词示例
good_prompts = [
    "一只橘色的小猫坐在窗台上，阳光透过窗户洒在它身上，温暖的光线，高画质，细节丰富",
    "现代简约风格的客厅，白色沙发，木质茶几，绿植装饰，自然光照，室内设计，高清摄影",
    "赛博朋克风格的未来城市，霓虹灯闪烁，高楼大厦，雨夜场景，电影级画质，科幻氛围."
]

# 避免的提示词
avoid_prompts = [
    "猫",  # 太简单
    "漂亮的图片",  # 太模糊
    "随便画点什么"  # 没有具体指导.
]

​
参数调优建议

# 不同场景的推荐参数
scenarios = {
    "写实摄影": {
        "size": "1024x1024",
        "watermark": True
    },
    "艺术创作": {
        "size": "1024x1024",
        "optimize_prompt_options": {"enable": True}
    },
    "快速原型": {
        "size": "512x512",
        "watermark": False
    }
}