API 和 SDK
平台 API 与 SDK 用于仓库和资产管理；推理网关 API 用于模型调用。二者地址和凭据不同。
| 场景 | 凭据 | 地址 |
|---|---|---|
| Git HTTPS、平台 API、CSGHub SDK | 当前实例的 Access Token | 平台 API 或仓库页面提供的 Git 地址 |
| Git SSH | 当前实例已登记的 SSH 公钥 | 仓库页面提供的 SSH 地址及端口 |
| 模型推理网关 | 当前实例的 API Key | 模型服务或实例 API 说明中的地址 |
平台 API
传神社区接口参考见 API 文档。自部署实例请向管理员获取与服务端版本对应的接口文档和平台 API 基础地址；不要把公共社区地址直接用于企业凭据。
从当前实例获取 Access Token，在运行环境设置 CSGHUB_TOKEN，并替换以下地址与用户名：
export CSGHUB_ENDPOINT="https://your-csghub.example.com"
export CSGHUB_USERNAME="your-username"
curl --fail-with-body "$CSGHUB_ENDPOINT/api/v1/user/$CSGHUB_USERNAME/run/mode" \
--header "Authorization: Bearer $CSGHUB_TOKEN"
传神社区的平台 API 基础地址示例为 https://hub.opencsg.com；推理网关地址应从服务页复制，不与平台 API 混用。
SDK 与 CLI
CSGHub SDK 提供 Python 和命令行工具。使用与当前实例兼容的客户端；执行前查看命令帮助。CLI 使用 --endpoint，Python 使用 endpoint 参数指定实例，模型和数据集分别使用 model、dataset 类型。
参数参考：官方 CLI 定义、Repository 定义。不同客户端版本的支持范围应以对应版本帮助为准。
模型调用
参见 网关快速开始，使用 API Key，不使用仓库 Access Token。