TensorOcean Global 文档

发送第一个 API 请求

准备三个配置值,在 Bash 或 Windows PowerShell 中收到第一条模型回复。

本页发送一条普通文本消息。完成后,你会看到模型回复,并能在控制台查看这次调用。

1. 准备账户和三个配置值

注册或登录 TensorOcean Global。注册需要能接收验证码的邮箱。如注册页面展示赠送活动,按注册赠送额度查看到账记录和有效期。

在控制台选择你要使用的工作空间:个人标准API使用 Credit,商用高并发使用钱包余额。先在账户总览或商用总览确认可用额度;需要补充时查看额度与计费。

配置去哪里复制
API Key在个人密钥或商用密钥中点击“创建新密钥”,填写用途和未来的有效期,创建后从列表复制
服务根地址使用同一密钥页面提供的服务地址;本页变量使用不带末尾 /v1 的根地址
模型 ID在对应工作空间的模型中心点击“复制模型名称”;商用可直接打开商用模型中心

本页使用 Chat Completions。选择可用于该接口的文本模型;如果模型说明没有明确接口支持,先用本页的短消息验证,遇到不支持的提示按模型与协议处理。不要把展示名称当作模型 ID。

2. 设置配置

选与你的终端相符的标签,在同一个终端完成后续步骤。替换模型占位符,在隐藏输入提示中粘贴 Key。商用请求将根地址改为 https://enterprise-api.tensorocean.com;密钥页面的当前地址优先。

export TENSOROCEAN_API_ORIGIN='https://llm-api.tensorocean.com'
export TENSOROCEAN_CHAT_MODEL='replace-with-model-id'
read -rsp 'TensorOcean Global API Key: ' TENSOROCEAN_API_KEY
printf '\n'
export TENSOROCEAN_API_KEY

3. 发送消息

需要支持 --fail-with-body 的 curl(7.76 或更新版本)。

curl --fail-with-body "$TENSOROCEAN_API_ORIGIN/v1/chat/completions" \
  -H "Authorization: Bearer $TENSOROCEAN_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<JSON
{
  "model": "$TENSOROCEAN_CHAT_MODEL",
  "messages": [{"role": "user", "content": "Reply with: Connected."}],
  "stream": false
}
JSON

4. 确认成功

回复中应包含模型生成的文本,例如下面的 Connected.。这是只保留关键字段的示意,具体措辞和其他字段可能不同:

{
  "choices": [
    {"message": {"role": "assistant", "content": "Connected."}}
  ]
}

看到了回复文本,且响应体没有 error,就完成了第一次调用。 某些参数错误也会返回 HTTP 200,所以只看 curl 退出码或 HTTP 状态不能确认成功。没有回复时,按API 故障排查检查错误。

到个人调用明细或商用用量按时间和模型核对记录。用量与结算可能稍后更新。

接下来打开 Python 或 TypeScript示例:沿用刚才的环境变量即可。密钥只放在受控的服务端环境,不要写入网页、公开仓库或截图。

本页目录