byted-seedream-image-generate

描述

使用火山引擎 Seedream 模型，基于文本提示词生成高质量图像。本技能提供三种强大的 Seedream 模型版本（4.0、4.5 和 5.0-lite），各自具备差异化能力，适用于不同使用场景。

适用场景

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

• 用户希望根据文本描述生成图像
• 用户需要生成多种艺术风格的图像作品
• 用户希望为创意项目生成视觉内容
• 用户需要 AI 驱动的图像生成功能
• 用户希望将参考图像转换为不同风格
• 用户需要批量生成多张图像
• 用户对图像质量有较高要求，需输出专业级图像

模型版本

功能特性

• 文生图（Text-to-Image）：基于详尽的文本描述生成图像
• 图生图（Image-to-Image）：将参考图像转换为指定艺术风格
• 批量生成（Batch Generation）：单次请求即可生成多张图像
• 多版本支持：可选 4.0、4.5 或 5.0-lite 模型
• 水印控制（Watermark Control）：支持关闭水印
• 自定义尺寸（Custom Sizes）：支持多种图像分辨率
• 输出格式（Output Formats）：PNG 与 JPEG 格式（仅 5.0-lite 支持）
• 网络搜索工具（Web Search Tools）：集成互联网搜索能力（仅 5.0-lite 支持）

安装与配置

前提条件

# 必需：API Key 配置
export MODEL_IMAGE_API_KEY="your-api-key-here"
# 或
export MODEL_AGENT_API_KEY="your-api-key-here"
# 或
export ARK_API_KEY="your-api-key-here"

# 可选：API 基础地址（默认已预设）
export MODEL_IMAGE_API_BASE="https://ark.cn-beijing.volces.com/api/v3"
# 或
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 "一只可爱的小猫在花园中玩耍"

指定模型版本

# 使用 4.0 版本
python seedream_image_generate.py -p "一只可爱的小猫" --version 4.0

# 使用 4.5 版本
python seedream_image_generate.py -p "一只可爱的小猫" --version 4.5

# 使用 5.0-lite 版本（推荐）
python seedream_image_generate.py -p "一只可爱的小猫" --version 5.0

高级选项

# 自定义尺寸且关闭水印
python seedream_image_generate.py -p "美丽的日落景象" -s 2048x2048 --no-watermark --version 5.0

# 批量生成
python seedream_image_generate.py -p "生成 3 张可爱狗狗图片" -g --max-images 3 --version 4.5

# 图生图
python seedream_image_generate.py -p "将此图像转换为动漫风格" -i "https://example.com/image.jpg" --version 5.0

# 网络搜索工具（仅 5.0-lite 支持）
python seedream_image_generate.py -p "2026 年最新款智能手机" --web-search --version 5.0

# 自定义输出格式（仅 5.0-lite 支持）
python seedream_image_generate.py -p "一幅壮丽的风景画" --output-format png --version 5.0

# 列出所有支持的版本
python seedream_image_generate.py --list-versions

命令行参数说明

Python API 调用方式

import asyncio
import sys

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

async def main():
    # 使用 5.0-lite 版本（默认）
    result = await seedream_generate([
        {
            "prompt": "一只可爱的小猫",
            "size": "2048x2048",
            "watermark": False,
            "output_format": "png"  # 仅 5.0-lite 支持
        }
    ], version="5.0")
    
    print(result)

asyncio.run(main())

版本选择指南

选择 4.0 版本，如果：

• 需要快速完成日常图像生成任务
• 对图像质量要求不高
• 更关注生成速度
• 处理简单场景和基础风格

选择 4.5 版本，如果：

• 追求更丰富的图像细节
• 处理包含大量元素或结构复杂的场景
• 需要更精准地还原特定艺术风格
• 对质量有中等偏上要求

选择 5.0-lite（推荐），如果：

• 追求最高图像质量
• 需要突破性的创意表达能力
• 对图像细节有极致要求
• 需要工具参数支持（例如 web search） ⭐
• 需要自定义输出格式（png/jpeg） ⭐
• 用于重要项目或正式工作场景

如不确定选哪个，请直接使用 5.0-lite！ ⭐

提示词工程建议

基础提示词结构

[主体描述] + [风格/艺术流派] + [光影/氛围] + [质量/分辨率]

进阶提示词（针对 5.0-lite 优化）

[主体描述], [创意风格/艺术流派], [独特视角/构图], [特殊光影/氛围], [强调 5.0-lite 的创意表达能力]

各版本参数支持情况

最终返回信息规范

您应返回三类信息：

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)

常见问题（FAQ）

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 文件。

注意事项

使用本技能时，请严格遵守火山引擎相关服务条款及国家法律法规。