跳到主要内容

Access Token

用途与获取方式​

Access Token 用于 Git HTTPS 操作、CSGHub 平台 API 和 SDK。推理网关使用独立的 API Key，Git SSH 使用 SSH Key，三者不能互相替代。

登录您正在使用的 CSGHub 实例，在 账号设置 → Access Token 中获取凭据。不要前往公共社区领取私有实例的凭据。

Access Token

刷新与保存​

Access Token 任意时刻只有一个有效值。刷新后，使用旧 Token 的脚本和客户端需要更新。泄漏时立即刷新。通过运行环境或密钥管理工具设置 CSGHUB_TOKEN，不把真实 Token 写入代码或 Git URL。

Git HTTPS​

从目标仓库页面复制 HTTPS 克隆地址。Git 提示输入用户名和密码时，用户名使用该实例账号，密码填写 Access Token；公开仓库是否需要认证以实际操作为准。

git lfs install
git clone https://your-csghub.example.com/datasets/your-namespace/example-dataset.git

平台 API 与 SDK​

自部署环境请向管理员获取平台 API 基础地址；此处使用占位域名。它不一定与 Web 地址相同，也不是以 /v1 结尾的推理网关地址。 CSGHUB_ENDPOINT 是本页示例使用的变量，CLI 通过 --endpoint 参数传入，Python 通过 endpoint 参数传入。

export CSGHUB_ENDPOINT="https://your-csghub.example.com"
export CSGHUB_USERNAME="your-username"
# 在运行环境中设置 CSGHUB_TOKEN 后执行
curl --fail-with-body "$CSGHUB_ENDPOINT/api/v1/user/$CSGHUB_USERNAME/run/mode" \
  --header "Authorization: Bearer $CSGHUB_TOKEN"

使用已安装的 csghub-sdk 下载一个有访问权限的模型：

import os
from pycsghub.snapshot_download import snapshot_download

result = snapshot_download(
    "your-namespace/example-model",
    repo_type="model",
    endpoint=os.environ["CSGHUB_ENDPOINT"],
    token=os.environ["CSGHUB_TOKEN"],
    cache_dir="./csghub-cache",
)
print(result)

将仓库 ID 替换成目标实例中的实际仓库；下载后检查返回目录中的模型文件。更多示例见 模型下载 和 数据集下载。