TensorOcean Global 文档

密钥与服务地址

创建 API Key,选择服务地址,复用环境变量并配置认证头。

第一次接入可直接完成首个请求。本页用于查询配置值和认证规则。

创建与使用密钥

先在控制台切换到 个人标准API 或 商用高并发,再打开对应的个人密钥或商用密钥页面。创建密钥时填写用途、选择有效期,创建后从列表复制实际 API Key。

使用 API Key 调用模型;官网登录密码、验证码、登录令牌和 App 的本地访问密钥都不能代替这里的云端 API Key。密钥的可用服务、额度和权限仍由账户当前配置决定。

地址怎么填

用途个人标准API商用高并发
服务根地址 / TENSOROCEAN_API_ORIGINhttps://llm-api.tensorocean.comhttps://enterprise-api.tensorocean.com
OpenAI SDK base_url / baseURLhttps://llm-api.tensorocean.com/v1https://enterprise-api.tensorocean.com/v1
Anthropic SDK base_url / baseURLhttps://llm-api.tensorocean.comhttps://enterprise-api.tensorocean.com

以所选服务密钥页面的当前配置为准。原始 HTTP 请求在根地址后追加 /v1/chat/completions、/v1/responses 或 /v1/messages;SDK 会自行追加相应接口路径。最终路径只应有一个 /v1。

环境变量约定

首个请求提供 Bash 和 Windows PowerShell 的设置命令。教程共用以下命名,无需在换用 SDK 时重新命名:

变量填写什么
TENSOROCEAN_API_ORIGIN不带末尾 /v1 的服务根地址
TENSOROCEAN_API_KEY从控制台复制的 API Key
TENSOROCEAN_CHAT_MODELChat Completions 示例使用的模型 ID
TENSOROCEAN_RESPONSES_MODEL仅在使用 Responses 示例时设置
TENSOROCEAN_MESSAGES_MODEL仅在使用 Anthropic Messages 示例时设置

例如,要使用 Responses,再设置该接口的模型变量。不要因为同一个模型能完成 Chat 请求,就假定它也支持 Responses。

export TENSOROCEAN_RESPONSES_MODEL='replace-with-responses-model-id'
# Only needed for Anthropic Messages:
export TENSOROCEAN_MESSAGES_MODEL='replace-with-messages-model-id'

请求头

Chat Completions 和 Responses:

Authorization: Bearer <TENSOROCEAN_API_KEY>
Content-Type: application/json

Anthropic Messages:

x-api-key: <TENSOROCEAN_API_KEY>
anthropic-version: 2023-06-01
Content-Type: application/json

Messages 也接受 Authorization: Bearer。同时发送两种密钥头时,Authorization 优先;只配置一种,避免旧值覆盖新值。示例固定使用 2023-06-01;版本头会转发到上游,其他版本需单独确认支持范围。

保管与更换

为不同应用和环境创建独立密钥。在服务端读取环境变量,不把密钥放进网页、分发的客户端、仓库或截图。交互式 API 页面会向所选地址发出请求,输入前核对地址。

密钥过期、被删除或疑似泄露时,在控制台创建新密钥,更新使用它的应用并撤销旧密钥。遇到错误,查看API 故障排查;HTTP 200 也可能包含 error,流建立后还需检查流内错误。

本页目录