API 已上线，访问流程产品化中
Gateway 访问与 Key
TokenDance Gateway 的公开访问路径、API key 边界、环境变量、最小验证和安全接入规则。
这页解决什么
TokenDance Gateway 是 live API 入口，但公开站点不直接发放真实 API key。本页把可以公开承诺的接入路径写清楚：base URL、凭据边界、环境变量、最小验证、接入证据和不应公开的信息。
访问路径
| 项目 | 公开值 | 说明 |
|---|---|---|
| Base URL | https://api.vectorcontrol.tech/v1 | OpenAI-compatible API base URL |
| Auth header | Authorization: Bearer $TOKENDANCE_API_KEY | 只使用 TokenDance API key；不要使用 TokenDance ID access token |
| Key 来源 | 受控发放流程 | 公开官网不展示、不生成、不回显真实 key |
| 推荐存储 | 服务端 secret、本地环境变量、受控 CI secret | 不要放到前端 bundle、localStorage、公开 issue 或截图 |
环境变量
| 变量 | 用途 | 公开示例 |
|---|---|---|
| TOKENDANCE_API_KEY | 模型 API 调用凭据 | 只展示变量名，不展示真实值 |
| TOKENDANCE_BASE_URL | OpenAI-compatible base URL | https://api.vectorcontrol.tech/v1 |
| TOKENDANCE_MODEL | 调用模型或别名 | 公开示例使用 your-model，占位不代表真实模型名 |
| TOKENDANCE_REQUEST_ID | 支持排查时的请求 id | 可提交脱敏 request id，不提交完整 provider payload |
最小验证
接入前先跑低成本请求，确认 key、base URL、模型名和网络路径正确，再接入 Agent、CI 或后端服务。
powershell
$env:TOKENDANCE_BASE_URL = "https://api.vectorcontrol.tech/v1"
curl.exe "$env:TOKENDANCE_BASE_URL/models" -H "Authorization: Bearer $env:TOKENDANCE_API_KEY"接入检查
- 确认拿到的是 TokenDance API key，而不是 TokenDance ID access token。
- 确认 SDK base URL 包含 `/v1`。
- 确认模型名来自当前可访问清单，不把内部模型名写进公开文档。
- 确认错误响应和 request id 被记录到私有支持证据里。
- 确认 key owner、用途、额度和轮换责任已经登记。
不能公开
- 真实 API key、完整 Authorization header、provider upstream key、admin token。
- 内部模型清单、私有 provider payload、用户 prompt、完整响应、私有日志。
- 生产主机路径、部署目录、数据库路径、SSH alias、回滚命令。