用途:该技能是 OpenRouter TypeScript SDK 的完整参考,帮助在 TypeScript 项目中通过统一 API 接入 300+ AI 模型,围绕 callModel 模式完成文本生成、工具调用、流式输出和多轮对话。
主要能力:callModel 是核心接口,支持字符串、消息数组和多模态(文本+图片)输入,可用 instructions 传系统指令。响应可通过 getText、getResponse(含 token 用量)、getTextStream、getReasoningStream、getToolCallsStream 等方法获取。工具用 Zod 定义 inputSchema/outputSchema,支持普通工具、generator 工具(eventSchema 进度事件)和手动工具(execute:false)。多轮可配 stopWhen,如 stepCountIs、maxCost、hasToolCall 或自定义条件;支持动态参数、nextTurnParams 上下文注入;提供生成参数如 temperature、maxOutputTokens、topP、frequencyPenalty、presencePenalty、stop;并支持 OpenAI/Claude 格式互转。
使用方式:安装 npm install @openrouter/sdk;初始化 new OpenRouter({ apiKey: process.env.OPENROUTER_API_KEY });在 openrouter.ai/settings/keys 获取密钥,用 export OPENROUTER_API_KEY=... 设置。也可用 OAuth PKCE 流程(createAuthCode、exchangeAuthCodeForAPIKey)面向用户应用生成密钥。API 密钥本身可通过 apiKeys 的 list、create、get、update、delete 和 getCurrentKeyMetadata 管理。
适用场景:服务端应用直接使用 API 密钥;面向用户的应用用 OAuth PKCE;需要类型安全、自动工具执行和流式输出的 Agent 与聊天应用。
限制:资料未说明具体定价、速率限制或模型可用性差异;使用需自行保管密钥,建议用环境变量、定期轮换并加密存储用户密钥。