快速解答： Telethon 使用的
api_id和api_hash来自 Telegram 开发者应用，通常按整数 ID 和字符串 Hash 配置。它们不是手机号、机器人 Token，也不是 GetTGAPI 授权码。申请时卡在 ERROR，可先联系本站客服；已经拿到资料的，先检查配置。
代码中的 api_id、api_hash 对应哪两个值？
api_id 对应门户里的 API ID；api_hash 对应 API Hash。搜索“Telethon apiid”“Telegram apihash 获取”时，指的通常也是这两个字段。
Telethon 的入门文档使用开发者门户获取应用资料，再将其用于客户端初始化。本文按文档当前稳定版 1.45.0 的写法说明；其他大版本应对照对应版本文档。Telethon Signing In
尚未申请，从哪里获取？
使用你有权操作的现有 Telegram 账号，进入 my.telegram.org 的 API development tools。已有应用先读取原资料；没有应用时再填写表单。详细步骤见 API ID 申请教程。
在这个阶段只有 ERROR、表单提交失败或 [object Object] 时，问题仍在开发者资料获取流程。可以通过 gettgapi.com/help#contact 联系 GetTGAPI 客服，说明卡住的步骤，不需要先把程序或账号会话交给客服。
已有结果：先检查格式，不先重新申请
| 配置项 | 应填内容 | 常见填错方式 |
|---|---|---|
api_id |
你取得的数字 ID | 填手机号、Bot 用户 ID、授权码或整行说明文字 |
api_hash |
与该 ID 配套的完整 Hash 字符串 | 少复制字符，带空格、换行，或填入 Bot Token |
| 会话名称或文件 | 你的程序按文档管理的本地会话 | 把它误当成 API Hash 或对外分享 |
| 登录码与两步密码 | 程序发起用户授权后按提示处理 | 把门户确认码和客户端登录码混用 |
不要将某个代码仓库的示例值当作自己的凭证，也不要在反馈问题时粘贴完整配置。
一个只检查本地配置的 Python 示例
先通过你自己的运行环境或密钥管理工具设置 TG_API_ID 和 TG_API_HASH，不要把真实值写进公开仓库。下面只读取和检查格式，不会连接 Telegram、发验证码或登录账号：
import os
import re
raw_id = os.environ.get("TG_API_ID", "").strip()
raw_hash = os.environ.get("TG_API_HASH", "").strip()
if not re.fullmatch(r"[0-9]+", raw_id) or int(raw_id) <= 0:
raise ValueError("TG_API_ID must be a positive integer")
if not re.fullmatch(r"[0-9a-fA-F]{32}", raw_hash):
raise ValueError("Check the complete API Hash copied from the portal")
api_id = int(raw_id)
api_hash = raw_hash
print("Local format check passed; credentials were not printed")
这里按门户常见的 32 位十六进制 Hash 做本地检查；如果你的结果格式不同，先回到官方应用资料核对。格式通过不证明这两个值配套、有效或已经完成用户登录。 后续客户端初始化与授权按你使用的 Telethon 版本文档进行。
分清三种失败，避免重复付费
- 网页创建失败。 还没有 ID 和 Hash，参考 门户 ERROR 排查，需要时找客服协助申请。
- 配置错误。 已有结果，程序却提示转换失败、缺少环境变量或
API_ID_INVALID。先检查程序实际读取的值、ID/Hash 是否配套及环境配置，见 API_ID_INVALID 专题。 - 用户授权问题。 程序开始请求登录码或两步密码，说明正在处理账号登录。购买另一组开发者资料不能代替账号验证，也不能保证解决登录问题。
例如，只在一个终端设置了环境变量，另一个服务进程仍读到空值，这属于程序运行环境问题。重新申请不会自动把配置传到另一个进程。
机器人 Token 能替代 api_hash 吗？
不能混填。Telethon 的机器人登录示例仍使用 API ID 与 Hash 初始化客户端，并另外提供 Bot Token。若只是直接使用 HTTP Bot API，应按那套接口文档配置 Token，不要把两种接入方式混为一谈。Telethon 机器人登录说明
配置完成后选择一个实际用途
想实现自动回复或定时通知，继续阅读 消息自动化与去重设计；想整理自己的记录，查看 聊天备份与检索。更多场景在 Telegram API 用途总览。先用自己的测试聊天验证一条任务，再处理长时间运行与失败恢复。
需要 GetTGAPI 客服帮助时
打开 gettgapi.com/help#contact，告诉客服你是“尚未取得 API 资料”还是“已经取得但程序报错”，附上脱敏后的错误文字与版本号即可。
本站提供开发者门户申请与已有资料读取协助，不代替所有第三方程序的调试服务。客服可先核对是否属于申请问题，再沟通后续办理；服务范围见 价格说明。