SDK 接入
TypeScript / Node.js
运行完整的服务端示例,再按需使用其他协议或流式输出。
使用 SDK 支持的 Node.js 版本,在同一终端设置首个请求中的环境变量。示例在服务端执行,不要将密钥打包到浏览器代码中。
1. 安装 SDK 和执行工具
在已有项目或新的空目录中运行:
npm install openai
npm install --save-dev tsx2. 保存并运行
将完整文件保存为 example.mts。.mts 扩展名支持 ESM 和顶层 await,无需修改已有项目的模块设置。
import OpenAI from 'openai';
function requiredEnv(name: string): string {
const value = process.env[name];
if (!value) throw new Error(`Missing ${name}`);
return value;
}
function assertSuccess(result: object): void {
if ('error' in result && result.error != null) {
const error: unknown = result.error;
const detail = typeof error === 'object' && error !== null
&& 'message' in error && typeof error.message === 'string'
? error.message : 'Request failed';
throw new Error(`TensorOcean Global API error: ${detail}`);
}
}
const client = new OpenAI({
apiKey: requiredEnv('TENSOROCEAN_API_KEY'),
baseURL: requiredEnv('TENSOROCEAN_API_ORIGIN').replace(/\/$/, '') + '/v1',
timeout: 60_000,
maxRetries: 0,
});
const chat = await client.chat.completions.create({
model: requiredEnv('TENSOROCEAN_CHAT_MODEL'),
messages: [{ role: 'user', content: 'Reply with: Connected.' }],
});
assertSuccess(chat);
console.log(chat.choices[0]?.message.content);npx tsx example.mts成功时会看到 Connected. 一类回复。assertSuccess 在读取文本前检查 HTTP 200 中的错误信封。失败时查看API 故障排查。
其他协议
按密钥与地址设置对应模型变量,只展开需要的接口。
按需开启流式输出
替换对应示例中的非流式调用,保留它的导入、辅助函数和客户端。每个片段各发送一次请求。异常应使本次任务失败,或由应用捕获并标记结果未完成。
示例关闭自动重试,并设置 60 秒超时。请按任务调整,生产项目固定依赖版本。重试前核对请求和工具执行状态:另一次生成可能再次计费。结束标记、流内错误和工具责任见流式输出与工具调用。