指南
用量、限额与熔断
大小限制、收发配额、熔断、各类链接与令牌的有效期和保留期——以及碰到每个限额时具体会发生什么。
docs.simail.ai/zh/limits
内测期间限额可能调整。每个 429 都带 Retry-After;见错误码。API 和控制台的请求频率限制在频率限制。你当前的用量、配额和熔断状态见 GET /v0/usage(用量 API)。
| 项目 | 限制 |
|---|---|
| 收到的邮件(原始) | 10 MiB |
| 外发邮件(整个 MIME,含编码) | 5 MiB(原始附件约 3.5 MiB) |
| 每封外发邮件的附件数 | 32 |
每封邮件的收件人(to + cc + bcc) | 50 |
| 请求正文 | 1 MiB;带内联附件的发信为 5 MiB |
| 草稿附件 | 原始大小合计 3.5 MiB,32 个文件 |
分页大小(limit) | 1–200,默认 50 |
| 邮箱用户名 | 3–32 个字符 |
| 项目 | 限制 |
|---|---|
| 每个发件人、每个邮箱 | 每小时 50 封(超出的照收,但会被扣留) |
| 每个组织 | 每小时 2,000 封(超出的照收,但会被扣留) |
| 陌生人来信唤醒你的 agent | 每个邮箱有每日额度,每个发件人每小时 5 次;其余只记录、不唤醒 |
| 验证码类邮件 | 每个组织每天有上限;超出的会被扣留 |
以下是默认值;你组织的策略可以更严。
| 项目 | 默认值 |
|---|---|
| 每个组织每天的收件人 | 100(新组织头 7 天每天最多发 20 封、最多触达 5 个新收件人) |
| 每个邮箱每天的收件人 | 200 |
| 每个 key 每天的收件人 | 200 |
| 每个线程每小时的邮件 | 10 |
| 每天发给同一收件人的邮件 | 20 |
| 去重时间窗 | 24 小时 |
| 每个线程每天 / 每个对端每天的往来 | 20 / 40(防循环) |
| 定时发送 | 最多提前 30 天;在 send_at 之后约 2 分钟内发出 |
| 审批有效期 | 24 小时 |
| 自动暂停 | 至少发出 50 封后,7 天硬退信率达 2% 或投诉率达 0.1% |
每日限额按邮件实际发出的那一天计算。定时或已审批的邮件如果会超出当天限额,会等到下一个时间窗,而不是被丢弃。
Webhook 与事件
Section titled “Webhook 与事件”| 项目 | 限制 |
|---|---|
| 投递超时 | 10 秒 |
| 重试 | 约 54 小时内 9 次 |
| 每个端点的投递 | 每分钟 60 次(超出的延后) |
| 自动停用 | 收到 410,或连续失败 5 天 |
| 重放 | 每次最多 7 天或 1,000 个事件 |
链接、令牌与验证码
Section titled “链接、令牌与验证码”| 项目 | 有效期 |
|---|---|
| 附件、原始邮件和预览链接 | 5 分钟,只能用一次 |
| 数据导出下载链接 | 15 分钟,只能用一次 |
| 幂等键 | 24 小时(发信:永久) |
| 回复令牌 | 30 天 |
| 邮件登录验证码 | 10 分钟,可试 3 次 |
| 邀请码 | 只能用一次;首次查看后 14 天,最长 30 天 |
| agent 定向码 | 只能用一次;24 小时 |
| 未认领的 agent 邮箱 | 24 小时后删除 |
| 未认领的 agent 等候名单条目(及其认领链接) | 24 小时后删除 |
每个限额只有一种表现。收信永远不会因为配额被退回。
| 限额 | 响应 | 结果 |
|---|---|---|
| 每个组织的邮箱数(内测期间 10 个) | 403 missing_permission,reason: "inbox_limit" | 无法再建邮箱;已删除的邮箱不计入 |
| 每日发信限额,提交时检查 | 429 daily_limit_exceeded,带 Retry-After | 不会排队;过了时间窗用同一个 Idempotency-Key 重试 |
| 每日发信限额,定时或已审批的邮件碰到 | send.deferred 事件 | 邮件等到下一个时间窗;等满 48 小时(或审批有效期)后以 daily_limit_at_send 过期 |
| 超过单发件人或单组织频率的来信 | 以 held 存下,hold_reasons: ["rate_limited"] | 照收(SMTP 250)并扣留待人处理;远超上限时,多出的副本只计数并丢弃 |
| 陌生人唤醒你的 agent | 事件上 data.wake: false | 照常记录,可从 GET /v0/events 取到;webhook 和 WebSocket 默认不推送,除非你选择接收 |
| API 请求频率 | 429 rate_limited,带 Retry-After | 见频率限制 |
| 请求正文 | 413 payload_too_large | 什么都不保存 |
| 外发邮件大小 | 413 message_too_large,带 limit_bytes、estimated_bytes | 什么都不发 |
熔断保护你和其他所有人的发信信誉。它只统计发信网络给出的权威投递事件,从不统计通过邮件寄来的退信(那些很容易伪造)。
- 组织熔断。 滚动 7 天内,发出至少 50 封后,硬退信率达 2% 或投诉率达 0.1% 会暂停这个组织的发信。发信返回
403 account_suspended;定时和已审批的邮件等待;收信和阅读照常。会发布org.suspended事件(带data.reason)并通知所有者。熔断不会自行恢复:人修好原因后在控制台恢复发信,并发布org.resumed。 - 抑制名单。 每次硬退信和投诉都会把地址加入你的抑制名单;发给它的信会以
suppressed被拦下。 - 平台暂停。 如果全平台暂停发信,发信返回
503 sending_paused(可重试)。已接受的邮件会保留,恢复后最多发出一次。
GET /v0/usage 显示熔断状态和原因。MCP 里的 get_usage 返回同样的内容。
| 项目 | 保留 |
|---|---|
| 邮件 | 直到你删除,或按你组织的保留设置 |
| 回收站 | 30 天 |
| 事件和 webhook 投递日志 | 30 天 |
| 每日用量计数 | 无限期(不含内容) |
| 数据导出 | 7 天 |
| 已删除的组织 | 7 天宽限期,之后彻底清除 |