GPTMail 临时邮箱 API 快速上手:Key、收信、限流与子域名

用 GPTMail API 可以生成临时地址、查询收件箱、读取或删除邮件。本文提供当前接入流程与常见陷阱,完整接口参数统一链接到官方文档。

内容核对:2026 年 11 月 15 日。原始发布日期保留;动态价格、额度和可用范围请以链接中的现行说明为准。

GPTMail 官方产品展示图;API 完整参数以现行文档为准。
GPTMail 官方产品展示图;API 完整参数以现行文档为准。 点击图片查看原图。

接入前准备

API 基础地址为 https://mail.chatgpt.org.uk,请求头使用 X-API-Key。从GPTMail 最新 API 文档获取当天公共测试 Key,或登录管理自己的个人 Key 和积分。不要再使用旧文章中的固定测试 Key 或已停止服务的商店入口。

最小请求示例

下面只展示地址生成,不会发邮件、注册第三方账号或修改现有收件箱。请把密钥放在环境变量中:

curl --fail-with-body -H "X-API-Key: $GPTMAIL_API_KEY" "https://mail.chatgpt.org.uk/api/generate-email"

得到完整邮箱地址后,在你自己的测试流程中向它发送邮件,再查询收件箱。不要把示例域名 example.com 当作实际可收信域名。

常用接口

用途方法与路径注意
生成地址GET / POST /api/generate-email域名与前缀参数见官方文档
查询收件箱GET /api/emails?email=完整地址对地址进行 URL 编码
读取一封邮件GET /api/email/{id}?email=完整地址同时传邮件 ID 与对应地址
删除一封邮件DELETE /api/email/{id}?email=完整地址不可把读取与删除混为一谈
清空收件箱DELETE /api/emails/clear?email=完整地址可能分批处理;检查 has_more
公开域名目录GET /api/domains/public据此选择当前有效后缀
统计GET /api/stats以文档中的字段和权限为准

子域名怎么用?

公开域名目录会列出可用子域名。支持 wildcard 的项目可使用允许的一层前缀;不支持通配时,从返回的 children 中选取。邮箱用户名是 @ 前的部分,不是子域名前缀。私有域名和登录专享域名不通过公开 API Key 开放。

稳定调用的四个检查

  • 先检查 HTTP 状态码及 Content-Type,再解析 JSON;代理或平台错误可能返回 HTML。
  • 生成地址的 GET/POST 共用来源 IP 速率限制:当前为每 10 秒 30 次。出现 429 时遵循 Retry-After,并使用退避。
  • 不要为每次收信轮询重新生成邮箱;保留完整地址,适度轮询,避免占用共享资源。
  • 清空接口是破坏性操作;has_more 为 true 时表示仍有待处理批次,不能把一次响应当成全部删除完成。

安全与保存期限

公开临时收件箱不适合敏感信息、金融账号、密码找回和长期通信;邮件最多保留 24 小时。已知可用域名下的邮箱地址可以按有效用户名组合,但这不代表有账号所有权或隐私保证。

本文不再复制整份接口参考,以免返回字段更新后产生两套互相矛盾的文档。请求体、响应示例、错误码与实时规则请查看GPTMail 最新 API 文档;密钥获取方式另见API Key 与积分指南。

上一篇 下一篇

评论与讨论

已有 9 条评论

  • 匿名
    匿名 2025年11月15日 08:49
    邮件里有图片,图片上写着验证码,无法正常显示
    • ChatGPT
      ChatGPT 2025年11月15日 08:52
      暂时还不支持附件,这个功能后续会添加。
    • 匿名
      匿名 2025年11月20日 03:33
      多次尝试无法收到验证码
    • ChatGPT
      ChatGPT 2025年11月20日 09:29
      已经修复了
  • 匿名
    匿名 2025年11月16日 04:20
    库存没了
    • AIblog
      AIblog 2025年11月16日 05:37
      测试key还有额度的。
  • 匿名
    匿名 2026年1月20日 18:18
    可不可以提供在Linux Do以外的地方购买额度的方式啊,这个论坛实在是注册不进去啊哭了
  • 匿名
    匿名 2026年3月3日 04:13
    不能copy为markdown或者下载为md文档吗?给agent看方便多了
  • 匿名
    匿名 2026年3月6日 08:28
    api key Daily quota exceeded incrased it
有想法?一起聊聊
欢迎补充信息、提出问题或分享你的使用体验。
写下评论
comment url