This skill should be used when the user wants to generate images using Seedream, the image generation model from ByteDance on Volcengine platform. Triggers include requests like 用Seedream生成图片, seedream画图, generate image with seedream, 调用seedream, 用豆包画图, or any request to create, draw, or generate images via the Seedream API.
本 Skill 帮助通过火山引擎方舟平台(Volcengine Ark)的 Seedream 系列模型生成图片,支持文生图(text-to-image)和图生图(image-to-image,Seedream 4.0+)。
ARK_API_KEYpip install 'volcengine-python-sdk[ark]'pip install openai在生成图片前,需要明确:
doubao-seedream-3-0-t2i-250415(详细模型列表见 references/api_reference.md)1024x1024、1792x1024如果用户未明确提到模型,默认使用 Seedream 4.0(doubao-seedream-4-0-250828)。
To verify the environment is ready, run:
echo $ARK_API_KEY
If the API key is missing, instruct the user to set it:
export ARK_API_KEY="your_api_key_here"
Use the bundled script at scripts/generate_image.py:
# 基本用法(文生图)
python3 ~/.workbuddy/skills/seedream-image-gen/scripts/generate_image.py \
--prompt "一只可爱的橘猫坐在窗边看夕阳,写实摄影风格" \
--output output.png
# 指定模型
python3 ~/.workbuddy/skills/seedream-image-gen/scripts/generate_image.py \
--prompt "a cyberpunk city at night" \
--model doubao-seedream-4-0-250828 \
--output output.png
# 指定尺寸
python3 ~/.workbuddy/skills/seedream-image-gen/scripts/generate_image.py \
--prompt "横版风景画,超宽屏" \
--size 1792x1024 \
--output landscape.png
# 生成多张
python3 ~/.workbuddy/skills/seedream-image-gen/scripts/generate_image.py \
--prompt "卡通风格的小动物" \
--n 4 \
--output animals.png
# 使用 OpenAI 兼容模式
python3 ~/.workbuddy/skills/seedream-image-gen/scripts/generate_image.py \
--prompt "描述内容" \
--sdk openai \
--output result.png
--output 指定url 格式时,脚本会自动下载图片到本地如果希望直接生成代码调用,可用以下模板:
import os
from volcenginesdkarkruntime import Ark
client = Ark(api_key=os.environ.get("ARK_API_KEY"))
resp = client.images.generate(
model="doubao-seedream-3-0-t2i-250415",
prompt="YOUR_PROMPT_HERE",
response_format="url",
)
url = resp.data[0].url
print("图片 URL:", url)
# 下载图片
import urllib.request
urllib.request.urlretrieve(url, "output.png")
print("已保存至 output.png")
| 场景 | 推荐模型 |
|---|---|
| 通用文生图,快速稳定 | doubao-seedream-3-0-t2i-250415 |
| 高质量图片,支持参考图 | doubao-seedream-4-0-250828 |
| 最新最强效果 | doubao-seedream-4-5-251128 |
| 极速轻量 | doubao-seedream-5-0-lite |
references/api_reference.mdscripts/generate_image.py