搜 seedream 5.0 pro api 避坑的人,多半已经踩过一次:图出得不差,账单却比预估高一截;或者批量跑一半卡在限速上。这篇不铺概念,按「计价单位、参数默认值、重试与批量、上线前核对」四段走一遍,告诉你每一步该看哪个数字、什么情况下这套判断不适用。单价和规格请到站内页面看当期数字,本文不写死。
搜 seedream 5.0 pro api 避坑的人,大多已经交过一次学费:图看着还行,账单比预估高一截;或者批量跑着跑着卡在限速上,反复重试又烧一轮。这篇不铺概念,就按出图链路从头到尾捋一遍,哪一步该盯哪个数、哪个参数最容易漏,一次说清。
先说清楚:本文不写任何具体单价、档位数字。所有价格、规格、模型版本这些会变的东西,一律到站内对应页面核对当期口径。你手里拿的应该是「检查方法」,不是一串背下来的数字——那种数字下个月就可能过期。
先弄清它按什么扣,再谈贵不贵
出图接口的计价单位通常不是 token,而是按张、按尺寸档位或者按出图次数算。同一个模型换个尺寸档,单价就可能不一样。拿文字模型那套「每百万 token 多少钱」去套图片,是最常见的第一个误判。
判断自己属于哪种情况很简单:翻一遍你的请求体,只要出现了分辨率、张数、参考图数量这类字段,它们八成参与计价。把这些参数原样写进日志,跑一天,钱花在哪一档自己就浮出来了。到 AI 官方 API 价格(/official-api) 核对当期口径,别凭记忆。
- 请求里带尺寸、清晰度、张数的,按档计价的可能性高,优先记这三个字段
- 以为一次请求只出一张图,实际一次可能出多张,扣费按张累加
- 批量脚本里循环次数和实际出图数对不上,账单就会超预期
- 参考图数量也常参与计价,上传几张和扣多少有关
参数默认值是最容易被忽略的那一格
很多人接入后第一件事是调效果,把提示词改了十几遍,却没看请求体里那些压根没写的字段。尺寸、质量档、输出数量、是否走高清增强,这些留空的项会落到平台默认值上,而默认值往往不是最便宜的那一档。
做法是在测试环境里用同一段提示词跑三组,每次只动一个参数,记下耗时和扣费。哪一项一动费用就跳档,生产代码里就把它写成显式常量,别留空。代价是多几行代码,换来的是账单可预测。
| 参数 | 留空的常见后果 | 建议做法 |
|---|---|---|
| 输出尺寸 | 落到默认大尺寸档 | 按业务实际需要的最大尺寸写死 |
| 出图数量 | 默认出多张,费用翻上去 | 显式传 1,批量需要再多传 |
| 质量/清晰度档 | 默认高档 | 先跑低档看效果够不够 |
| 参考图数量 | 多传一张就多一份成本 | 限制上传张数并做前端校验 |
有一种情况这套做法不适用:如果平台对未传字段本来就按最低档处理,那显式传参反而把上限锁死,灵活性没了。所以先看文档确认默认值,再决定哪些留空、哪些写死。
重试和限速,钱是从这里二次流出的
图片接口超时比文字接口常见得多,一超时就自动重试。如果重试没做幂等,同一段提示词、同一个时间窗,可能被扣两次。排查顺序是先翻请求日志,看有没有重复的同一提示词加同一时间窗——有,就是重复扣费的源头。
被限速卡住之后,最忌讳的是固定间隔硬重试。压满并发只会让失败率更高,重试更多,账单更高。改成退避加队列,把任务排好队慢慢消化,总耗时未必更长,费用却稳得多。
- 先查重复请求按提示词哈希加时间窗分组,看有没有同一组出现两次以上,有就说明重试没做幂等。
- 再调并发把并发降到平台建议值以下,观察失败率变化;失败率降下来再逐步加,找到拐点。
- 改成退避失败后按指数退避重试,设重试上限,别无限次自动重来。
- 验证跑一批任务,对比改前改后的失败请求占比和总扣费,两个数一起看。
判断标准很直接:日志里失败请求占比明显偏高,问题在并发和超时设置上,不在模型贵不贵。别急着换更便宜的模型,先把重试这层理干净。
上线前的四步核对清单
前面几节都是在讲哪里会漏,这一节给一套上线前必须走完的核对动作。目标只有一个:让「实际扣费」和「你的预估」对得上,一次对不上就说明还有字段没看见。
第一步,用一批真实业务提示词跑全量流程,逐条记出图数、尺寸档、耗时和扣费。别用测试用的假数据,真实提示词的参数组合才会暴露问题。第二步,把日志字段固定下来,至少包含请求 id、参数快照、返回张数、扣费金额,缺一个后面都查不清。
第三步,拿一天的用量乘单价,跟平台账单对一次。对不上就回到参数快照,看是哪一档跳了。第四步,给任务加预算闸,超过阈值自动停,别等月底才看到数字。
账单口径可以去 模型成本计算器(/tools/model-cost-calculator) 估,价格有没有变去 模型价格变动(/price-watch) 看当期数字。这两处都别用记忆里的旧值,价格调整不会挨个通知你。
下一步把上面四步里你还没做的那一步挑出来补上,尤其是参数快照和预算闸,真正做到位之后再谈优化出图质量。对照站内的价格与变动页面核对当期数字,比背一串会过期的价格靠谱。→常见问题
seedream 5.0 pro api 按张还是按 token 收费?
图片生成接口常见是按出图张数或尺寸档位计价,不是文字模型那种每百万 token 的算法。具体以官方价格页当期口径为准,去站内 AI 官方 API 价格页面核对,别用文字模型的单价去折算图片成本,两套账不能混算。
为什么我的实测账单比按单价算出来的高?
大概率是三处:一次请求出了多张图但按一次算、重试没做幂等导致重复扣费、尺寸或质量档用了默认的高档。把请求参数快照和返回张数写进日志,跑一天就能定位是哪一项在跳档。
批量出图被限速了该怎么处理?
别用固定间隔硬重试,改成队列加退避,把并发压到平台稳定区间。失败率高的批次先单独跑小样本测上限,再决定批量大小。这时候要调的是调度策略,不是换更贵的档位。