API 参考图片
Seedream
字节跳动 Seedream 图片模型接入:文生图、图生图,以及各模型适用的尺寸与像素范围。
Seedream(即梦图片)系列模型通过 OpenAI 兼容的图片接口调用,支持文生图与图生图。
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | https://token.aiznt.com/v1/images/generations |
| 认证方式 | Header Authorization: Bearer sk-你的密钥 |
| 模型名 | doubao-seedream-5-0-lite-260128(以控制台模型列表为准) |
文生图
curl https://token.aiznt.com/v1/images/generations \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "doubao-seedream-5-0-lite-260128",
"prompt": "一只在键盘上打盹的橘猫,写实摄影风",
"size": "2K"
}'from openai import OpenAI
client = OpenAI(
# OpenAI SDK 会在 base_url 后拼接 /images/generations,必须保留 /v1。
base_url="https://token.aiznt.com/v1",
api_key="sk-你的密钥",
)
result = client.images.generate(
model="doubao-seedream-5-0-lite-260128",
prompt="一只在键盘上打盹的橘猫,写实摄影风",
size="2K", # 2K 是以下四个模型共同支持的预设
)
print(result.data[0].url)Python 示例为何会返回 404?
OpenAI 客户端的 base_url 必须是 https://token.aiznt.com/v1。如果写成 https://token.aiznt.com,SDK 会请求不存在的 /images/generations,而不是正确的 /v1/images/generations。
尺寸规则
size 可以使用模型支持的分辨率预设,也可以使用 WIDTHxHEIGHT 明确指定宽高。四个模型的规则不同,不能统一写成 1K / 2K / 4K。
| 模型 ID | 可用预设 | 明确宽高的总像素范围 | 默认值 |
|---|---|---|---|
doubao-seedream-4-0-250828 | 1K、2K、4K | 921,600–16,777,216 | 2048x2048 |
doubao-seedream-4-5-251128 | 2K、4K | 3,686,400–16,777,216 | 2048x2048 |
doubao-seedream-5-0-lite-260128 | 2K、3K、4K | 3,686,400–16,777,216 | 2048x2048 |
doubao-seedream-5-0-pro-260628 | 1K、1.5K、2K | 921,600–4,624,220 | 2K |
使用 WIDTHxHEIGHT 时还必须满足宽高比范围 [1/16, 16]。总像素是宽度与高度的乘积,不是对单边长度的限制。
四个模型通用的安全取值
预设值只有 2K 可用于以上四个模型。若明确指定宽高,应同时满足 3,686,400–4,624,220 总像素和 [1/16, 16] 宽高比;例如 1920x1920。
示例:
{
"size": "1920x1920"
}尺寸预设以大写 K 书写。上述范围依据火山引擎图片生成 API 当前规则及 AIZNT 接口错误信息整理;模型升级后请以最新接口返回为准。
图生图
在请求中通过 image 携带单张参考图 URL/Base64,或使用字符串数组传入多张参考图。不同模型支持的参考图数量和组图能力不同,请以所用模型的接口说明为准。