Skip to main content

​
豆包图片生成示例

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

​
快速开始

curl -X POST "https://model-api.skyengine.com.cn/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
  }'

​
重要提示

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

​
支持的参数

​
基础参数

  • prompt: 图片描述文本（必需）
  • model: 模型名称，默认 doubao-seedream-4-0-250828
  • size: 图片尺寸（如：256x256, 512x512, 1024x1024）
  • response_format: 返回格式（url 或 b64_json）
  • seed: 随机数种子，-1表示随机（⚠️ 注意：doubao-seedream-4-0-250828模型可以传入此参数但不生效）

​
画质控制参数

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

​
高级功能参数

  • stream: 是否启用流式输出，默认 false
  • sequential_image_generation: 组图功能控制（enabled 或 disabled）
  • sequential_image_generation_options: 组图功能配置
    • max_num: 最大图片数量
  • optimize_prompt_options: 提示词优化配置
    • enable: 是否启用提示词优化
  • image: 基础图片，支持URL或Base64编码（用于图片编辑）

​
图片到图片生成示例

豆包还支持基于现有图片生成新图片的功能，通过 image 参数提供参考图片URL： 
curl -X POST "https://model-api.skyengine.com.cn/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://model-api.skyengine.com.cn/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://model-api.skyengine.com.cn/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": "xxxxx"
    }
  ],
  "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
    }
}