用途:该技能用于安装当前 Together 客户端、将凭据置于源码管理之外,并通过不消耗推理额度的模型列表请求验证访问权限。
主要能力:面向 Python 的 together>=2.0.0(v2 SDK)与 TypeScript SDK;SDK 默认读取 TOGETHER_API_KEY,REST 使用 Authorization: Bearer <token>;密钥按 Together 项目隔离,建议区分开发、CI 与生产密钥;用 client.models.list() 或 GET /v1/models 做只读验证。
使用方式:先盘点语言、包管理器、现有 OpenAI 兼容客户端与部署环境;固定当前主版本 SDK 并在锁文件中记录解析版本;在本地文档与部署配置中定义 TOGETHER_API_KEY,但不把值写入仓库;初始化原生 Together 客户端,或用 https://api.together.ai/v1 配置 OpenAI 客户端;执行一次只读模型列表探测,仅记录状态、项目别名、SDK 版本与模型数量;记录密钥归属、轮换、吊销与环境隔离。
适用场景:新项目接入 Together AI、CI 环境鉴权、部署环境凭据注入与验证。
限制与边界:未经项目管理员不得创建、泄露、扩大、轮换或吊销生产密钥;不得将凭据加入受跟踪文件、命令历史、测试夹具或对不可信分支开放的 CI。错误处理:401 确认注入与项目选择且不打印密钥;402 上报计费/支出限制;OpenAI 模型 ID 返回 404 时改用当前 Together 模型 ID;密钥暴露立即吊销或轮换并清理日志。