一句话回答:申请 Telegram API ID 和 API Hash 只需 4 步——用官方 App 登录账号、打开 my.telegram.org 用同一手机号登录、进入「API development tools」填写 App 名称、提交后即可拿到 api_id 与 api_hash。下面跟着 YouTube 上的真实教程图解走,并重点解决最让人头疼的「创建应用报 ERROR」问题。
一、API ID / API Hash 是什么?和 Bot Token 有何区别?
API ID(一个整数)和 API Hash(一段 32 位字符串)是开发 MTProto 用户端、做账号自动化(如 Telethon、Pyrogram)时的核心鉴权凭据,绑定在你的个人账号上。
它和 Bot Token 不是一回事:Bot Token 由 @BotFather 发放、用于机器人;而 api_id / api_hash 来自 my.telegram.org,用于以「用户身份」调用 Telegram API。
YouTube 上这类教程非常多,下图是搜索「telegram api id hash my.telegram.org tutorial」的真实结果,本文步骤与配图正是参考了其中 TECHNO KRRISH、TG Guy、guideBut、MR.Ruslanikys 等创作者的公开教程。
图 1:YouTube 上关于 Telegram API ID / Hash 申请的热门教程(来源:YouTube 搜索结果实拍,含 TECHNO KRRISH、TG Guy、guideBut 等创作者)
二、申请前要准备什么?
- 一个已注册并能登录的 Telegram 账号:必须先用官方 App 登录。
- 账号绑定的手机号:验证码通过 Telegram App 内下发(不是短信)。
- 一个干净网络环境:尽量用住宅家宽 / 蜂窝流量,关闭 VPN 与广告拦截插件(关键,见第五节)。
三、官方流程是怎样的?(依据 Telegram 官方文档)
Telegram 官方文档「Creating your Telegram Application」给出的标准步骤如下图,核心就是:登录 my.telegram.org → 进入 API development tools → 填表 → 拿到 api_id / api_hash。
图 2:Telegram 官方文档明确说明 api_id 获取步骤与「每个号码只能连接一个 api_id」(来源:core.telegram.org 官方文档实拍)
四、跟着 YouTube 教程一步步申请(图解)
步骤 1:登录 my.telegram.org。浏览器打开 https://my.telegram.org/auth ,在「Your Phone Number」填入账号绑定的手机号(国际格式,如 +8613800000000),点击 Next。
图 3:my.telegram.org 官方登录页(来源:my.telegram.org 官网实拍)
步骤 2:输入 App 内验证码。Telegram 会通过 App 给你发一条「Login code」,回到网页填入 Confirmation code,登录成功。下图是 YouTube 创作者 TECHNO KRRISH 教程中演示的手机端登录界面,和官网完全一致。
图 4:登录与验证码步骤演示(来源:YouTube 创作者 TECHNO KRRISH 教程视频截图,youtube.com/watch?v=zYv_BnmTago)
步骤 3:进入 API development tools。登录后点击页面上的「API development tools」。
步骤 4:填写 Create new application 表单。只有 App title 和 Short name 两个字段是必填且之后可改,URL 可留空,平台随便选。
步骤 5:点击 Create application,复制凭据。提交后页面立即显示 api_id 和 api_hash。把它们复制保存好——api_hash 无法重新查看或重置。
五、创建应用时一直报「ERROR」怎么解决?
这是社区里最高频的坑:填完表点 Create application,页面只回一个红色的 ERROR,没有任何说明。多位 YouTube 创作者(如 guideBut、MR.Ruslanikys、Himanshu Gheu)都专门做过解决视频,综合官方与社区经验,原因几乎都和网络/IP 风控有关。
| 报错原因 | 解决方案 |
|---|---|
| 开着 VPN / 机场代理(最常见) | 关闭 VPN 与代理,改用干净住宅家宽或手机蜂窝流量 |
| 浏览器插件 / 广告拦截干扰 | 换浏览器或开无痕模式,禁用 AdBlock 等扩展 |
| IP 国家与账号注册地不符 | 使用与账号手机号同一国家/地区的纯净 IP |
| App title 含敏感词 / 特殊字符 | 改一个普通的英文名称,去掉表情和符号 |
| 新号 / 异常账号被风控 | 换一个注册时间更久、状态正常的账号 |
六、拿到 api_id / api_hash 后的安全与封号注意
- 官方明确警告:用 API 刷粉、刷阅读、群发垃圾信息会被永久封号。
- 所有用非官方客户端登录的账号都会被自动列入观察,请合规使用。
- 绝不要使用别人的 api_id / api_hash,Telegram 会判定为可疑并封号;也不要把自己的 hash 公开到 GitHub。
- 若未违规却被封,可写邮件到 [email protected] 说明用途申请解封(邮件由人工审核,自动生成的邮件会被识别)。
七、总结
申请 Telegram API ID / Hash 本身很简单:登录 my.telegram.org → API development tools → 填 App title 和 Short name → 拿 api_id 和 api_hash。真正的难点是创建时的 ERROR,九成是代理/VPN 的 IP 被风控,关掉代理换干净 IP 基本就能解决。拿到凭据后务必妥善保管、合规使用,避免封号。
常见问题(FAQ)
Q1:申请 Telegram API ID 收费吗?
不收费。Telegram 欢迎开发者免费使用 API 和开源代码,但需遵守 API 服务条款。
Q2:一个账号 / 手机号能申请几个 api_id?
目前每个手机号只能连接 1 个 api_id,拿到后在不同项目里复用即可,不需要也无法重复申请。
Q3:my.telegram.org 创建应用一直报 ERROR 怎么办?
最常见原因是开着 VPN/机场代理。先彻底关闭代理,换无痕浏览器,必要时用与账号同国家的纯净家宽或蜂窝流量重试。
Q4:api_hash 忘了或泄露了怎么办?
api_hash 无法重新查看也不能重置,请务必保存好;一旦泄露,使用该凭据的账号有被风控风险,切勿公开。
如果觉得自己操作太麻烦,可以直接去 aaadoy海外账号购买平台 购买现成的账号,方便快捷,售后有保障。

🌐 需要海外账号?我们覆盖全品类
Apple ID · Telegram · Netflix · Spotify · Facebook · Instagram · TikTok · ChatGPT
🛒 前往商店购买