漫小白API 文档
下载完整 .md ↓

Seedream 5.0 Lite / Pro 生图

Seedream 是图片模型,Seedance 是视频模型。两者名称相近,但请求接口、型号与计费不同。本站 Seedream 使用 Images JSON,推荐异步提交、查询、下载。

型号与规格

2026-11-01 核对,Key 选择 mj和Seedream生图专用分组。以下为倍率 1 的当前公开价,完整价格以模型广场为准。

model 档位 resolution 每次输出 当前价格
seedream-5.0-lite 2k / 4k,默认 2k 1 张 ¤0.07 / 张
seedream-5.0 1k / 2k,默认 1k 1 张 ¤0.09 / 张

Pro 的请求 ID 是 seedream-5.0,不是自行添加的 seedream-5.0-pro。Pro 不应按 Lite 的参数传 4k;需要 4K 时选择 Lite。本站已有 Lite 双参考 4K 和 Pro 2K 成功记录,分别交付过 3840×2160 和 2816×1584;档位不代表每个比例都使用完全相同的长边。

Lite:4K 中文海报

json
{
  "model": "seedream-5.0-lite",
  "prompt": "商业产品海报:蓝色陶瓷杯,米白背景。主标题「一杯好时光」,副标题「让每一天从温暖开始」,中文清楚可读,留白充足。",
  "resolution": "4k",
  "size": "16:9",
  "n": 1
}

下载 seedream-lite-4k.json,执行:

bash
curl --fail-with-body --max-time 60 \
  https://openpix.cc/v1/images/generations/async \
  -H "Authorization: Bearer $MXB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @seedream-lite-4k.json

Pro:2K 产品图

同一入口,下载并使用 seedream-pro-2k.json。

json
{
  "model": "seedream-5.0",
  "prompt": "白色桌面上的陶瓷茶壶,柔和自然光,保留釉面纹理。",
  "resolution": "2k",
  "size": "16:9",
  "n": 1
}

字段与比例

字段 类型 要求
model string 两个完整 ID 之一,Key 须有权限
prompt string 非空,说明主体、背景、布局和需出现的文字
resolution string 建议显式使用表内小写档位
size string 本页推荐比例写法,例如 16:9、1:1、9:16
n integer 固定 1
image string 可选,单个可访问图片 URL 或图片 Data URL
images string[] 可选,多图 URL / Data URL 数组,顺序对应 prompt 中的“图一、图二”

比例参数可用 auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21。为避免档位推断差异,当前推荐显式 resolution 加比例 size,而不是只传一个像素值。

Lite 参考图数量上限为 6,Pro 为 10;本站真实验证包含 Lite 双图,满数量组合没有逐一实测。请先以所需少量素材验证效果。GPT 的 high/xhigh/max、MJ 的数字 quality 不作为 Seedream 本页已确认参数,最小请求省略 quality。

多参考图

将 seedream-reference.json 中的示例地址替换为自己的图片,提交到与文生图相同的 /v1/images/generations/async。

json
{
  "model": "seedream-5.0-lite",
  "prompt": "以图一为产品主体,图二为色彩参考,制作横幅海报,标题「慢下来,喝杯茶」。",
  "resolution": "4k",
  "size": "16:9",
  "n": 1,
  "images": [
    "https://media.example.com/product.png",
    "https://media.example.com/colors.png"
  ]
}

图片 URL 必须完整、可访问,不能是需要登录的页面。也可用完整 Data URL;本地文件可交给图片 Python 客户端的 --reference,程序会转换格式并按顺序追加。此页不把 JSON 参考图成功等同于所有 multipart、遮罩和精确局部重绘能力都已验证。

结果与效果检查

HTTP 202 后保存 task_id,用 GET /v1/images/tasks/{task_id} 查询。completed 后读取 data[].url 或 result.data[].url;同步 /v1/images/generations 则直接等待 data。具体字段见任务章节。

下载后检查真实尺寸、主体一致性及文字。模型能够生成中文,不代表长文逐字排版绝无错漏;此前海报实测出现过末句重复。把需要原样出现的文字用引号分开,避免同一段要求相互矛盾,关键文字成品应人工校对。

常见问题

问题 处理
请求了 4K 却选 Pro Pro 当前是 1k/2k,改用 Lite 的 4k
只写 size 后尺寸不符合预期 显式传 resolution 与比例,下载解码核对实际像素
参考图没有被采用 检查字符串数组、URL 可访问性,并说明每张图用途
收到 429 控制并发,先确认本次是否已有任务,不自动重复提交收费 POST
HTTP 200/202 但没有图片 区分任务回执和完成结果,查询 error 及最终状态

固定按张价不使用 total_tokens 算费;同一任务有预留/退款时合并核对。批量需求采用多次独立任务,每次 n=1,避免把一个 MJ 的多图行为套用到 Seedream。

漫小白 API 接入文档 · 2026-11-02 更新 · 当前目录与接口契约核对
模型权限与费用以当前模型广场及账单为准。

复制 Markdown

浏览器未允许自动复制,内容已选中,可按 Ctrl+C / ⌘C 复制。