跳转到内容
Vibeit 使用手册

配置 Hugging Face Token

适用版本: 1.0.1iPad · iPhone内容核对日期: 截图界面: 简体中文Standard / Pro

你将完成什么

Section titled “你将完成什么”

保存 Hugging Face Token，并使它在新启动的 Python 内核中生效。

开始前准备

Section titled “开始前准备”
  • 有效的 Standard、Pro 订阅，或符合条件的试用。
  • 能够连接本教程所用服务或下载资源的网络。
  • 若资源要求身份验证，需要 Hugging Face 账号和具有所需权限的 Token。

下载教程示例项目

从哪里进入

Section titled “从哪里进入”
Settings → Environment → Hugging Face Token

逐步操作

Section titled “逐步操作”
  4. import os
print("HF_TOKEN present:", bool(os.environ.get("HF_TOKEN")))
try:
    from huggingface_hub import HfApi
    HfApi().whoami(token=True)
    print("Hugging Face authorization: OK")
except Exception as error:
    status = getattr(getattr(error, "response", None), "status_code", None)
    print("Authorization error:", type(error).__name__, "HTTP:", status)
·
放大查看操作位置
1. 打开环境页面 — 进入“设置 → 环境”。Hugging Face 字段位于这里，不在 AI 服务列表中。
打开环境页面
1
2. 输入访问 Token — 使用具有所需资源访问权限的 Token。受限模型还可能要求先在 Hugging Face 上获得访问许可。
输入访问 Token
2
3. 完全关闭并重新打开 Vibeit — 先保存文件。打开系统多任务视图，上划 Vibeit 的卡片关闭 App，再点击 Vibeit 图标重新打开。仅返回主屏幕不会重新启动 App。
完全关闭并重新打开 Vibeit
3
4. 验证变量与授权 — 运行示例。HF_TOKEN present: True 表示内核已读取 Token；Hugging Face authorization: OK 表示服务已接受授权。受限模型的访问许可仍需单独获得。
import os
print("HF_TOKEN present:", bool(os.environ.get("HF_TOKEN")))
try:
    from huggingface_hub import HfApi
    HfApi().whoami(token=True)
    print("Hugging Face authorization: OK")
except Exception as error:
    status = getattr(getattr(error, "response", None), "status_code", None)
    print("Authorization error:", type(error).__name__, "HTTP:", status)
验证变量与授权
4

核对结果

Section titled “核对结果”

运行示例。HF_TOKEN present: True 表示内核已读取 Token；Hugging Face authorization: OK 表示服务已接受授权。受限模型的访问许可仍需单独获得。

如果没有成功

Section titled “如果没有成功”
  • 新保存的 Token 或环境变量未生效时，重启内核。
  • 遇到 401/403 时，检查 Token 和资源的账号访问权限。
  • 下载成功但不能加载时，检查格式、所需依赖和可用内存。

下一步

Section titled “下一步”

相关资料

Section titled “相关资料”

联系支持