发送第一个 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_KEY3. 发送消息
需要支持 --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
}
JSON4. 确认成功
回复中应包含模型生成的文本,例如下面的 Connected.。这是只保留关键字段的示意,具体措辞和其他字段可能不同:
{
"choices": [
{"message": {"role": "assistant", "content": "Connected."}}
]
}看到了回复文本,且响应体没有 error,就完成了第一次调用。 某些参数错误也会返回 HTTP 200,所以只看 curl 退出码或 HTTP 状态不能确认成功。没有回复时,按API 故障排查检查错误。
到个人调用明细或商用用量按时间和模型核对记录。用量与结算可能稍后更新。
接下来打开 Python 或 TypeScript示例:沿用刚才的环境变量即可。密钥只放在受控的服务端环境,不要写入网页、公开仓库或截图。