你在写图片生成的教程或帮助文档,最容易踩的坑是计费口径没对齐:按张、按步、按订阅额度,三种说法混在一篇里,用户照着算出来的钱对不上账。这篇给一套写法:先定口径,再定示例,最后给自检清单,让教程能被客服直接拿去回复用户。
写图片生成教程,最常见的翻车不是技术写错,而是计费口径前后不一。同一篇文档里前面说按张扣、后面按额度折算,用户拿自己的用量一算,数字对不上,客服就要挨个解释。这篇只讲一件事:怎么把计费教程写成一个口径、能自算、边界不漏的版本。
写法分三步走:先定唯一主线口径,再把口径翻译成用户的一次操作,最后把示例写成可套用的公式,发布前过一遍自检清单。目标不是把计费讲得多全,而是让用户看完知道自己这次操作会扣什么、在哪里能查到实时数字。
第一步:先把计费单位定下来,别在一篇里混着说
计费单位决定了整篇教程的骨架。动笔前先内部确认对外承诺的是哪一种口径,把它定成主线,其他口径只能作为对照出现,并且明确标注「仅供参考,以站内页面为准」。口径不确定就别写,先去站内核对当前说法。
| 口径类型 | 用户怎么感知 | 写法要点 |
|---|---|---|
| 按生成张数 | 点一次出一张就扣一次 | 主线口径,操作与扣费一一对应 |
| 按推理步数 | 同一张图不同参数消耗不同 | 必须解释步数在哪调,默认值是多少 |
| 按订阅额度折算 | 看剩余额度而不是单价 | 说明额度怎么消耗、怎么查余额 |
| 混合口径 | 某些操作走张数、某些走额度 | 分开列清楚,别混在同一段 |
- 同一篇教程里只保留一个主线口径,其余口径统一放进「其他口径说明」小节
- 对照口径后面必须跟上「以站内实时页面为准」这类指向,不要留孤立数字
- 如果平台确实同时存在两种计费方式,按操作类型拆成两张小表,别写成一段话
第二步:把计费单位翻译成用户的一次操作
用户不关心后台怎么算,只关心「我点这一下要花多少」。教程要做的映射是:把每个会扣费的操作列出来,写清它对应哪个计费单位、走哪条路径。凡是会让用户额外花钱的旁路操作,一个都不能省。
| 用户动作 | 是否计费 | 教程里怎么写 |
|---|---|---|
| 正常生成一张 | 是 | 按主线口径说明扣多少 |
| 放大或重绘 | 常额外计费 | 单独列出,说明触发条件 |
| 批量队列 | 按条累加 | 给出批量预估公式 |
| 失败重试 | 看平台规则 | 单独一段,说明失败与取消的区别 |
| 中途取消 | 可能已计费 | 写清在哪个节点前取消不扣 |
失败、重试、取消这三类边界情况是客服被问最多的。教程里不要用一句「具体以实际为准」打发,而要写清判断节点:任务提交后到哪一步算已消耗、重试是重新扣还是复用上一次。判断标准写出来,客服才能直接复制回复。
- 列出全部扣费动作把产品里所有会触发扣费的操作穷举一遍,包括按钮、接口、批处理和定时任务
- 逐个标注计费口径每个动作后面写上走的是哪个计费单位,不确定的标黄而不是猜
- 补边界情况针对失败、重试、取消、超时各写一句判断条件,说明在哪个节点开始计费
- 交叉验证拿一个真实操作路径走一遍,看教程描述和后台实际扣费是否一致
第二步补充:口径与操作的常见错位
最容易错的不是漏写,是写对了口径却对错了操作。比如正文说按张计费,但批量接口实际按条累加;或者默认参数下走的是低成本模式,用户改了参数就跳到另一档。这类错位光读文档看不出来,必须动手跑一遍。
- 默认参数和自定义参数可能走不同计费档,教程要注明参数改动会不会影响扣费
- 网页端和接口端口径可能不一致,两边都要写,别默认相同
- 免费额度、试用额度和付费额度消耗顺序不同,查余额的路径也要写清
- 并发或排队是否影响计费,取决于平台实现,不确定就别下结论
第三步:示例怎么写才不给用户挖坑
示例的作用是让用户能自己算,不是给一个标准答案。写死单价的示例过一阵就过期,教程维护成本高还容易误导。正确做法是把单价抽成变量,只写计算过程,单价一律指向站内实时页面。
总消耗 = 单次消耗 × 成功次数 + 重试消耗 × 重试次数;单次消耗与重试规则:到站内计费说明页核对当时的数值;用户把「成功次数」「重试次数」换成自己的用量即可估算。| 示例写法 | 问题 | 改法 |
|---|---|---|
| 直接写「每张 X 元」 | 价格一变整篇作废 | 改为「假设单价为 P,到站内页面查 P」 |
| 只给结论不给过程 | 用户无法套用自己用量 | 补上乘法和加法步骤 |
| 忽略重试次数 | 估算偏低,用户觉得被坑 | 把重试作为独立变量列出来 |
| 用固定日期举例 | 日期失效后示例失真 | 用「某次生成」这类中性描述 |
发布前自检清单
教程上线前过一遍下面这几条。过不了就别发,发出去之后客服的咨询量会直接反映文档质量。如果平台规则正在调整,先在文档里留出「规则以站内页面为准」的入口,再补细节。
- 通篇只有一个计费主线口径,对照口径都标了「仅供参考」
- 所有数字都能追溯到站内页面,没有写死的价格、跑分、版本号和日期
- 覆盖了失败、重试、批量、取消四类边界情况,且各自有判断条件
- 客服能直接复制其中一段回复用户,不需要再补充解释
- 示例写成可套用公式,用户换成自己的用量就能估算
- 有一个明确的「去哪查实时数字」路径,且路径真实可达
什么情况下这套清单不适用:如果你的产品还在计费规则灰度期,口径本身每周都在变,那就不要写完整教程,先出一页「当前规则说明 + 查询入口」,等口径稳定再补示例和自检内容。
下一步去站内看各家 API 与套餐的当前计费口径,再对照价格追踪页确认变化节奏,写教程时引用链接而不是抄数字。→常见问题
教程里到底能不能写具体价格?
不建议写死。价格会变,写死的数字过一阵就是错的,还会误导用户来投诉。更稳的写法是写清计算过程和公式,把单价指向站内价格页,让读者自己去看当时的数字。
按张计费和按步计费,教程该按哪个写?
看你产品对用户实际承诺的是哪种扣费方式。如果两种都存在,正文只留一种主线,另一种放到对照说明里并标注适用场景,否则用户按错的口径算账会觉得被坑。
用户生成失败还扣费,教程里怎么说?
先确认真实规则,再单独列一段说明失败、取消、超时分别怎么处理。这段不能含糊,写「一般不计费」这种模糊表述,等于把问题推给客服。规则以站内计费说明页为准。