OpenAI 自动注册工具

自动化注册 OpenAI 账号，使用临时邮箱接收验证邮件，支持一键生成欧洲账单 URL。

功能特点

• ✅ 自动生成临时邮箱：通过临时邮箱 API 自动创建邮箱
• ✅ 多域名支持：支持选择不同的邮箱域名后缀（最多 3 个）
• ✅ 自动接收验证邮件：轮询等待 OpenAI 发送的验证码
• ✅ 自动提取验证码：从邮件中提取并提交验证码
• ✅ 成功/失败管理：成功注册的邮箱保留，失败的自动删除
• ✅ 批量注册：支持一次注册多个账号
• ✅ 欧洲账单生成：自动生成 ChatGPT Team Plan 欧洲账单 checkout URL
• ✅ 完整日志：详细的调试输出，方便排查问题

🚀 快速开始

方式 1: Telegram Bot (推荐)

最简单的使用方式，无需命令行操作：

# 1. 安装依赖
uv pip install -e .

# 2. 配置 config.py（临时邮箱设置）
cp config.example.py config.py
nano config.py

# 3. 设置 Bot Token
export TELEGRAM_BOT_TOKEN='your_bot_token_here'

# 4. 启动 Bot
./deployment/start_bot.sh

详细教程: docs/TELEGRAM_BOT_GUIDE.md

功能:

• 📱 Telegram 界面操作
• ✅ 自动注册账号
• ✅ 获取 Access Token
• ✅ 生成欧洲账单 URL
• 🔐 用户访问控制

方式 2: 命令行工具

1. 配置临时邮箱 API

复制配置模板并填入真实信息：

cp config.example.py config.py

编辑 config.py，填入你的临时邮箱 API 信息：

TEMPMAIL_CONFIG = {
    'api_base_url': 'https://your.tempmail.domain',  # 你的临时邮箱域名

    # 方式1：用户名密码登录（推荐）
    'username': 'your_username',  # 你的临时邮箱系统用户名
    'password': 'your_password',  # 你的密码

    # 方式2：JWT Token（备用）
    # 'admin_token': 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...',

    # 域名选择(0=第1个域名, 1=第2个, 2=第3个)
    'domain_index': 0,  # 改成 0, 1, 或 2 来选择不同的域名后缀
}

临时邮箱 API 文档见：docs/tempmail.md

2. 安装依赖

# 使用 uv (推荐，更快)
uv pip install -e .

# 或使用传统 pip
pip install -r requirements.txt

3. 注册账号

注册 1 个账号（自动生成邮箱和密码）：

python auto_register.py

使用方法

📋 命令合集（Command Reference）

🔹 基础注册

# 注册 1 个账号（自动生成邮箱和密码）
python auto_register.py

# 注册 10 个账号
python auto_register.py --count 10

# 注册 5 个账号，使用相同密码
python auto_register.py --count 5 --password "MySecurePassword123!"

# 保存到指定文件
python auto_register.py --count 10 --output my_accounts.json

# 完整示例：注册 20 个账号，指定密码和输出文件
python auto_register.py --count 20 --password "MyPassword123!" --output accounts.json

🔹 注册 + 生成欧洲账单

# 注册 1 个账号并生成欧洲账单 URL
python auto_register.py --eu-billing

# 批量注册 10 个账号并生成账单
python auto_register.py --count 10 --eu-billing

# 完整示例：批量注册 + 账单 + 自定义输出
python auto_register.py --count 5 --password "MyPass123!" --eu-billing --output team_accounts.json

🔹 已注册账号生成账单

# 批量生成账单（从 registered_accounts.json 读取）
python generate_billing.py

# 从自定义文件读取并生成账单
python generate_billing.py --input my_accounts.json --output billing_urls.json

# 单个账号生成账单
python generate_billing.py --email user@example.com --password "MyPassword123!"

---

批量注册

注册 10 个账号：

python auto_register.py --count 10

指定密码

所有账号使用相同密码：

python auto_register.py --count 5 --password "MySecurePassword123!"

自定义输出文件

保存到指定文件：

python auto_register.py --count 10 --output accounts.json

注册 + 欧洲账单生成

注册账号的同时生成欧洲账单 checkout URL：

# 注册 1 个账号并生成账单
python auto_register.py --eu-billing

# 批量注册 10 个账号并生成账单
python auto_register.py --count 10 --eu-billing

已有账号批量生成账单

对已注册的账号批量生成欧洲账单 URL：

# 从 registered_accounts.json 读取账号
python generate_billing.py

# 从自定义文件读取
python generate_billing.py --input my_accounts.json --output billing_urls.json

# 单个账号生成账单
python generate_billing.py --email user@example.com --password "MyPassword123!"

完整示例

# 批量注册 20 个账号，指定密码，生成账单，保存到自定义文件
python auto_register.py \
  --count 20 \
  --password "MyPassword123!" \
  --eu-billing \
  --output team_accounts.json

配置说明

欧洲账单配置

在 config.py 中可以自定义欧洲账单参数：

EU_BILLING_CONFIG = {
    'plan_name': 'chatgptteamplan',
    'team_plan_data': {
        'workspace_name': 'Sepa',           # 工作空间名称
        'price_interval': 'month',          # 'month' 或 'year'
        'seat_quantity': 5,                 # 座位数量（最少 5 个）
    },
    'billing_details': {
        'country': 'DE',                    # 国家代码（DE, FR, IT 等）
        'currency': 'EUR',                  # 货币
    },
    'promo_campaign': {
        'promo_campaign_id': 'team-1-month-free',  # 促销码
        'is_coupon_from_query_param': False,
    },
    'checkout_ui_mode': 'redirect',
}

域名选择

临时邮箱支持多个域名后缀，通过 domain_index 参数选择：

TEMPMAIL_CONFIG = {
    # ...
    'domain_index': 0,  # 0 = 第1个域名, 1 = 第2个, 2 = 第3个
}

这样可以避免某个域名被 OpenAI 屏蔽时，切换到其他域名继续注册。

调试模式

调试输出在 config.py 中控制：

DEBUG = True   # 打印详细日志
DEBUG = False  # 静默模式

输出格式

注册账号输出（registered_accounts.json）

普通注册（无账单）：

[
  {
    "email": "random123@domain.com",
    "password": "MyPassword123!",
    "verified": true
  }
]

注册 + 账单生成（使用 --eu-billing）：

[
  {
    "email": "random123@domain.com",
    "password": "MyPassword123!",
    "verified": true,
    "checkout_url": "https://chatgpt.com/checkout/openai_llc/cs_xxx..."
  }
]

账单生成输出（billing_urls.json）

使用 generate_billing.py 的输出格式：

[
  {
    "email": "user@example.com",
    "checkout_url": "https://chatgpt.com/checkout/openai_llc/cs_xxx...",
    "generated_at": "2026-01-11T08:30:00Z"
  },
  {
    "email": "fail@example.com",
    "error": "Failed to retrieve access token: HTTP 401"
  }
]

工作流程

完整注册流程（含账单生成）

1. 生成临时邮箱          [TempMailClient.generate_mailbox()]
   ↓
2. 初始化 OpenAI 注册流程 [OpenAIRegistrar._step1_init_through_chatgpt()]
   ↓
3. 初始化 Sentinel        [_step2_init_sentinel() + _step2_5_submit_sentinel()]
   ↓
4. 解 PoW                 [_step2_6_solve_pow() + _step2_7_submit_pow()]
   ↓
5. 提交注册请求           [_step3_attempt_register()]
   ↓
6. 等待验证邮件           [TempMailClient.wait_for_email()]
   ↓
7. 提取验证码             [TempMailClient.extract_verification_code()]
   ↓
8. 提交验证码             [_step4_verify_email()]
   ↓
9. 获取 Access Token      [_step5_get_access_token()]  ← 新增
   ↓
10. 生成欧洲账单          [EUBillingGenerator.generate_checkout_url()]  ← 新增
   ↓
11. 注册完成
   ├─ ✓ 成功 → 保留邮箱 + 账单 URL
   └─ ✗ 失败 → 删除邮箱  [TempMailClient.delete_mailbox()]

文件结构

.
├── auto_register.py          # 主脚本（批量注册 + 可选账单生成）
├── generate_billing.py       # 独立账单生成工具
├── tg_bot.py                 # Telegram Bot 主程序 ✨
├── config.example.py         # 配置模板
├── config.py                 # 配置文件（需自行创建）
├── requirements.txt          # Python 依赖
├── pyproject.toml            # uv 项目配置
├── deployment/               # 部署相关文件
│   ├── Dockerfile            # Docker 镜像
│   ├── docker-compose.yml    # Docker Compose 配置
│   ├── start_bot.sh          # Bot 快速启动脚本
│   ├── telegram-bot.service  # Systemd 服务配置
│   └── .env.example          # 环境变量模板
├── docs/                     # 文档
│   ├── CHANGELOG.md          # 更新日志
│   ├── TELEGRAM_BOT_GUIDE.md # Bot 部署指南 📖
│   └── tempmail.md           # 临时邮箱 API 文档
├── modules/
│   ├── register.py           # 注册逻辑 + Access Token
│   ├── billing.py            # 欧洲账单生成
│   ├── tempmail.py           # 临时邮箱客户端
│   ├── http_client.py        # HTTP 客户端
│   ├── fingerprint.py        # 浏览器指纹
│   ├── sentinel_solver.py    # Sentinel 求解
│   └── pow_solver.py         # PoW 求解
└── reference/                # 参考实现
    └── autoteam.py           # 账单生成参考

注意事项

临时邮箱系统

• 只保留成功注册的邮箱
• 失败的邮箱会自动删除，不占用空间
• 你可以在临时邮箱系统中查看所有成功注册的账号

速率限制

• OpenAI 可能有注册频率限制
• 建议在批量注册时添加延迟（如每个账号间隔 30 秒）
• 如遇到 429 错误，请降低注册速度

配置文件安全

• config.py 包含敏感信息，已加入 .gitignore
• 不要将 config.py 提交到 git 仓库
• 使用 config.example.py 作为模板

常见问题

1. 收不到验证邮件

• 检查临时邮箱 API 是否正常工作
• 检查邮箱域名是否被 OpenAI 屏蔽（尝试切换 domain_index）
• 增加等待时间（修改 wait_for_email() 的 timeout 参数）

2. PoW 求解失败

• 确保安装了 Node.js
• 检查 sdk.js 路径是否正确
• 增加 PoW 超时时间（config.py 中的 POW_CONFIG）

3. 注册被拒绝（409 Conflict）

• 邮箱可能已被使用（理论上临时邮箱应该是新的）
• OpenAI 可能检测到异常行为，尝试更换 IP

4. Cloudflare 403

• 可能触发了反爬虫检测
• 尝试更换 User-Agent（config.py 中的 FINGERPRINT_CONFIG）
• 添加延迟，降低请求频率

5. 某个域名被屏蔽

• 修改 config.py 中的 domain_index，切换到其他域名
• 例如：第1个域名不行就改成 domain_index: 1 或 domain_index: 2

许可证

MIT License