基础地址
你所在部署的域名。StarForge 没有公共多租户服务——每套安装都是独立的一台服务器，地址由管理员提供。 同一个域名同时提供控制台、API，以及反向代理在/docs 下的这份文档。
所有 API 路径都以 /api/ 开头，只有两个例外：
版本
两个版本号回答两个不同的问题。string
这个控制平面所讲的 JobSpec 方言，当前是
forge/v2。方言不一致的 CLI 根本无法在这里提交作业。
从 GET /api/version 读取。string
正在运行的
starforge-console 构建版本。报缺陷时有用；不要拿它做分支判断。请求与响应
- 请求体和响应体都是 UTF-8 的 JSON，请带上
Content-Type: application/json。 - 时间戳是带显式时区偏移的 ISO 8601：
2026-08-31T09:14:22+00:00。 - 日志流和指标流是 Server-Sent Events，不是 JSON——相关接口会写明。
- 上传走签名 URL 握手，字节不经过控制平面：先申请 URL，PUT 上去，再登记。
列表
列表接口接受limit 和 offset，直接返回数组，没有游标，也没有外层包装。
限流
只在滥用成本低的接口上按 IP 限流：登录每分钟 10 次，设备码轮询每分钟 20 次。超出返回429。
其余接口控制平面不限流；部署方在网关上可能另有策略。
下一步
认证
拿到 token、保持有效，以及为你要做的事挑对凭据种类。
错误
错误结构，以及常见拒绝到底意味着什么。
从训练代码回传
训练作业把曲线送进控制台所讲的那份契约。
Python SDK
starforge.report——三个函数，不假设任何训练框架。