byted-seedream-image-generate

byted-seedream-image-generate

描述

使用 Volcano Engine Seedream 模型，根据文本提示词生成高质量图像。本技能提供三个强大的 Seedream 模型版本（4.0、4.5 和 5.0-lite），各自具备独特能力，适用于不同的使用场景。

何时使用此技能

在以下情况下使用此技能：

• 用户想根据文本描述创建图像
• 用户需要生成各种艺术风格的作品
• 用户想为创意项目创作视觉内容
• 用户需要 AI 驱动的图像生成功能
• 用户想将参考图像转换为不同风格
• 用户需要批量生成多张图像
• 用户需要生成高质量、外观专业的图像

模型版本

版本	模型名称	发布日期	推荐指数	最适合
4.0	doubao-seedream-4-0-250828	2025 年 8 月	⭐⭐⭐	日常使用、快速生成
4.5	doubao-seedream-4-5-251128	2025 年 11 月	⭐⭐⭐⭐	注重细节的作品、复杂场景
5.0	doubao-seedream-5-0-260128	2026 年	⭐⭐⭐⭐⭐	最高质量、最佳创意、支持工具

功能特性

• 文生图：根据详细的文本描述生成图像
• 图生图：将参考图像转换为不同风格
• 批量生成：在单个请求中创建多张图像
• 多个版本：可选择 4.0、4.5 或 5.0-lite 模型
• 水印控制：可选择禁用水印
• 自定义尺寸：支持多种图像尺寸
• 输出格式：支持 PNG 和 JPEG 格式（仅限 5.0-lite）
• 网页搜索工具：集成互联网搜索（仅限 5.0-lite）

安装与设置

前提条件

# Required: API Key configuration
export MODEL_IMAGE_API_KEY="your-api-key-here"
# or
export MODEL_AGENT_API_KEY="your-api-key-here"
# or
export ARK_API_KEY="your-api-key-here"

# Optional: API Base URL (default already configured)
export MODEL_IMAGE_API_BASE="https://ark.cn-beijing.volces.com/api/v3"
# or
export ARK_BASE_URL="https://ark.cn-beijing.volces.com/api/v3"

脚本将按以下优先级使用配置：

1. 环境变量（ARK_API_KEY、MODEL_IMAGE_API_KEY、MODEL_AGENT_API_KEY）
2. 环境变量（ARK_BASE_URL、MODEL_IMAGE_API_BASE）
3. 默认值

用法

基本用法（推荐使用 5.0-lite 版本）

cd scripts
python seedream_image_generate.py -p "A cute kitten playing in a garden"

指定版本

# Use 4.0 version
python seedream_image_generate.py -p "A cute kitten" --version 4.0

# Use 4.5 version
python seedream_image_generate.py -p "A cute kitten" --version 4.5

# Use 5.0-lite version (recommended)
python seedream_image_generate.py -p "A cute kitten" --version 5.0

高级选项

# Custom size without watermark
python seedream_image_generate.py -p "Beautiful sunset" -s 2048x2048 --no-watermark --version 5.0

# Batch generation
python seedream_image_generate.py -p "Generate 3 cute dog pictures" -g --max-images 3 --version 4.5

# Image-to-image
python seedream_image_generate.py -p "Convert this image to anime style" -i "https://example.com/image.jpg" --version 5.0

# Web search tool (5.0-lite only)
python seedream_image_generate.py -p "Latest 2026 smartphone" --web-search --version 5.0

# Custom output format (5.0-lite only)
python seedream_image_generate.py -p "A beautiful landscape" --output-format png --version 5.0

# List all supported versions
python seedream_image_generate.py --list-versions

命令行选项

选项	快捷方式	描述	默认值
--prompt	-p	图像描述文本（必填）	-
--version	-v	版本选择：4.0、4.5、5.0	5.0
--size	-s	图像尺寸	2048x2048
--image	-i	单个参考图像 URL	-
--images	-	多个参考图像 URL（以空格分隔）	-
--group	-g	启用批量图像生成	false
--max-images	-	批量生成的最大图像数量	15
--output-format	-	输出格式：png 或 jpeg（仅限 5.0）	jpeg
--response-format	-	响应格式：url 或 b64_json	url
--stream	-	启用流式输出	false
--web-search	-	启用网页搜索工具（仅限 5.0）	false
--optimize-prompt-mode	-	提示词优化模式：standard 或 fast	-
--timeout	-t	超时时间（秒）	1200
--no-watermark	-	禁用水印	false
--list-versions	-	列出所有支持的版本	-

Python API 用法

import asyncio
import sys

sys.path.append("scripts")
from seedream_image_generate import seedream_generate

async def main():
    # Use 5.0-lite version (default)
    result = await seedream_generate([
        {
            "prompt": "A cute kitten",
            "size": "2048x2048",
            "watermark": False,
            "output_format": "png"  # 5.0-lite only
        }
    ], version="5.0")
    
    print(result)

asyncio.run(main())

版本选择指南

在以下情况下选择 4.0：

• 需要快速进行日常生成
• 对质量的要求不是特别高
• 需要更快的生成速度
• 适用于简单的场景和风格

在以下情况下选择 4.5：

• 希望呈现更丰富的细节
• 正在处理复杂场景
• 需要更好的风格还原
• 对质量有中等要求

在以下情况下选择 5.0-lite（推荐）：

• 希望获得最高质量
• 需要突破性的创意表达
• 对细节有极高要求
• 需要工具参数（例如网页搜索） ⭐
• 需要自定义输出格式（png/jpeg） ⭐
• 用于重要项目和工作

不确定时，请使用 5.0-lite！ ⭐

提示词工程技巧

基本提示词结构

[Subject Description] + [Style/Art Movement] + [Lighting/Atmosphere] + [Quality/Resolution]

高级提示词（针对 5.0-lite 优化）

[Subject Description], [Creative Style/Art Movement], [Unique Perspective/Composition], [Special Lighting/Atmosphere], [Emphasizing 5.0-lite creative expression]

各版本的参数支持情况

参数	Seedream 4.0	Seedream 4.5	Seedream 5.0-lite	说明
model	✅	✅	✅	模型名称
prompt	✅	✅	✅	提示词（必填）
image	✅	✅	✅	参考图像
size	✅	✅	✅	图像尺寸
sequential_image_generation	✅	✅	✅	批量生成控制
sequential_image_generation_options	✅	✅	✅	批量生成配置
response_format	✅	✅	✅	响应格式（url/b64_json）
watermark	✅	✅	✅	水印（true/false）
stream	✅	✅	✅	流式输出
optimize_prompt_options	✅	✅	✅	提示词优化配置
tools	❌	❌	✅	工具配置（仅限 5.0-lite）
output_format	❌	❌	✅	输出格式（png/jpeg，仅限 5.0-lite）

最终返回信息

对于 OpenClaw

1. 首先，将生成的图像保存/下载到允许的目录：

   • 推荐：~/.openclaw/workspace/

2. 使用 message tool 发送图像，并设置以下参数：

   {
     "action": "send",
     "message": "Optional text description",
     "media": "/root/.openclaw/workspace/generated-image.jpg"
   }
   

   • 该工具会自动：读取本地文件，将其上传到频道服务并生成网络 URL，然后以图像消息发送

3. 验证是否成功：检查工具是否返回 {"ok": true}，以确认图像已成功发送

4. 普通文本（不使用 message tool）：生成后，以 Markdown 格式显示图像列表，例如： 非常重要： 图像 URL 必须是以 https:// 开头的原始在线资源链接，不能是已下载图像的本地地址。

对于普通场景

你应该返回三类信息：

1. 文件格式、图像文件（如果有其他方式发送图像文件）以及图像的本地路径，例如： local_path: /root/.openclaw/workspace/skills/image-generate/xxx.png
2. 生成后，以 Markdown 格式显示图像列表，例如：

      ![generated-image-1](https://example.com/image1.png)
      ![generated-image-2](https://example.com/image2.png)

常见问题

Q：各版本有什么区别？

A：4.0 适合日常快速使用，4.5 为复杂场景提供更丰富的细节，5.0-lite 则提供最高画质，并支持独特的工具。

Q：生成的 URL 有效期是多久？

A：URL 有效期为 24 小时。请尽快下载并保存图像。

Q：参考图像支持哪些格式？

A：支持 JPG 和 PNG 等常见格式，可通过 URL 或 Base64 提供。

Q：一次调用可以使用多个版本吗？

A：目前一次调用只能使用一个版本。如需比较，请针对不同版本分别调用。

许可证

此技能采用 Apache License 2.0 许可。详情请参阅 LICENSE 文件。

注意事项

使用此技能时，请遵守火山引擎的服务条款以及相关法律法规。