密钥与服务地址
创建 API Key,选择服务地址,复用环境变量并配置认证头。
第一次接入可直接完成首个请求。本页用于查询配置值和认证规则。
创建与使用密钥
先在控制台切换到 个人标准API 或 商用高并发,再打开对应的个人密钥或商用密钥页面。创建密钥时填写用途、选择有效期,创建后从列表复制实际 API Key。
使用 API Key 调用模型;官网登录密码、验证码、登录令牌和 App 的本地访问密钥都不能代替这里的云端 API Key。密钥的可用服务、额度和权限仍由账户当前配置决定。
地址怎么填
| 用途 | 个人标准API | 商用高并发 |
|---|---|---|
服务根地址 / TENSOROCEAN_API_ORIGIN | https://llm-api.tensorocean.com | https://enterprise-api.tensorocean.com |
OpenAI SDK base_url / baseURL | https://llm-api.tensorocean.com/v1 | https://enterprise-api.tensorocean.com/v1 |
Anthropic SDK base_url / baseURL | https://llm-api.tensorocean.com | https://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_MODEL | Chat 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/jsonAnthropic Messages:
x-api-key: <TENSOROCEAN_API_KEY>
anthropic-version: 2023-06-01
Content-Type: application/jsonMessages 也接受 Authorization: Bearer。同时发送两种密钥头时,Authorization 优先;只配置一种,避免旧值覆盖新值。示例固定使用 2023-06-01;版本头会转发到上游,其他版本需单独确认支持范围。
保管与更换
为不同应用和环境创建独立密钥。在服务端读取环境变量,不把密钥放进网页、分发的客户端、仓库或截图。交互式 API 页面会向所选地址发出请求,输入前核对地址。
密钥过期、被删除或疑似泄露时,在控制台创建新密钥,更新使用它的应用并撤销旧密钥。遇到错误,查看API 故障排查;HTTP 200 也可能包含 error,流建立后还需检查流内错误。