TensorOcean Global 文档
SDK 接入

TypeScript / Node.js

运行完整的服务端示例,再按需使用其他协议或流式输出。

使用 SDK 支持的 Node.js 版本,在同一终端设置首个请求中的环境变量。示例在服务端执行,不要将密钥打包到浏览器代码中。

1. 安装 SDK 和执行工具

在已有项目或新的空目录中运行:

npm install openai
npm install --save-dev tsx

2. 保存并运行

将完整文件保存为 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 秒超时。请按任务调整,生产项目固定依赖版本。重试前核对请求和工具执行状态:另一次生成可能再次计费。结束标记、流内错误和工具责任见流式输出与工具调用。

本页目录