跳至正文
English获取 GPT 指南
文档中心
开始使用 / 文档首页

Stellahub API 文档

准备组织提供的接入信息，查询当前可用的模型 ID，然后发出第一条 OpenAI 兼容请求。

GPT 指南

先准备这三项

API KEY

Stellahub API Key

将组织发放的 Key 保存在本地环境变量或服务端密钥存储中。

OPENAI BASE URL

组织提供的 Base URL

使用组织提供的完整 OpenAI 兼容地址，本指南要求地址以 /v1 结尾。

MODEL

准确的模型 ID

从当前 API Key 有权访问的模型列表中复制 ID，不要根据产品名称猜测。

只有 API Key 还不能完成客户端配置。请向发放 Key 的组织索取匹配的 Base URL，不要替换为上游厂商的 Key。

配置环境变量

先复制下面的模板，再查询模型列表，最后选择 GPT 模型 ID。

OpenAI 兼容客户端

Shell / macOS / Linux
# 使用组织提供的完整地址，不要自行拼接路径。
export STELLAHUB_API_BASE_URL="<组织提供的 OpenAI Base URL，以 /v1 结尾>"
export STELLAHUB_API_KEY="<你的 Stellahub API Key>"
export STELLAHUB_MODEL="<从 /v1/models 返回的准确 ID>"

# OpenAI SDK 与兼容客户端
export OPENAI_BASE_URL="$STELLAHUB_API_BASE_URL"
export OPENAI_API_KEY="$STELLAHUB_API_KEY"

在 OpenAI SDK 和兼容客户端中统一使用组织提供的 Base URL。请将 Key 保存在源码、浏览器代码和截图之外。

查询模型并发送请求

API 使用 OpenAI 兼容的请求格式。先确认当前 Key 可以访问哪些模型：

GET /v1/models
curl "${STELLAHUB_API_BASE_URL}/models" \
  -H "Authorization: Bearer ${STELLAHUB_API_KEY}"

将 STELLAHUB_MODEL 设置为响应中准确的 id ，再发送一次非流式测试请求：

POST /v1/chat/completions
curl "${STELLAHUB_API_BASE_URL}/chat/completions" \
  -H "Authorization: Bearer ${STELLAHUB_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "${STELLAHUB_MODEL}",
    "messages": [{"role": "user", "content": "你好，请用一句话介绍你自己。"}],
    "stream": false
  }'
可用模型、功能表现和限制由返回的模型 ID 与 Key 的组织授权决定。正式使用前，请针对实际模型验证流式输出、工具调用、视觉、推理和上下文限制。

使用 GPT 专题指南

GPT 指南说明模型发现步骤，并提供 cURL、Python 和 Node.js 调用示例。

打开 GPT 指南

故障排查

  • 401：检查 Key 是否存在，且没有被截断。
  • 403：向 Key 发放方确认 Base URL 和组织授权。
  • 404：使用组织提供的完整 Base URL，不要重复拼接 /v1。
  • 429：与 Key 发放方检查配额和限流设置。
  • 模型不可用：重新执行 GET /v1/models，只使用当前 Key 返回的 ID。

常见问题

面向组织发放的 Stellahub 凭据，说明安全配置、接入与日常排查方式。

01

平台与访问

Stellahub 是什么？

Stellahub 提供 OpenAI 兼容的接入文档。发放凭据的组织决定 Base URL、可用模型和访问策略。

我需要分别注册每个模型厂商吗？

不需要。只使用组织发放的 API Key 与接口地址，不要替换为上游厂商的 Key。

我能调用哪些模型？

使用当前 API Key 执行 GET /v1/models，并从响应中复制准确的 id。该列表是当前 Key 可用模型的唯一依据。

02

安全使用

API Key 应该保存在哪里？

保存在本地环境变量或服务端密钥存储中。不要提交到代码仓库，也不要放进截图、浏览器代码或公开工单。

可以把 API Key 放在浏览器应用里吗？

不可以。公开的浏览器打包产物会泄露凭据，应通过自己的服务端或其他受访问控制的后端发起请求。

怀疑 Key 泄露后应该怎么办？

立即停止使用该 Key，并按组织的撤销或更换流程处理。寻求协助时只提供 Key 名称或后缀，不要发送完整值。

03

接入与兼容

需要重写应用吗？

通常不需要。配置组织提供的 Base URL 与 API Key，再使用 GET /v1/models 返回的准确模型 id。

支持哪些语言和 SDK？

任何能发起 HTTPS 请求的语言都可以接入。OpenAI SDK 与兼容客户端可使用组织提供的 Base URL；上线前请验证实际模型能力。

可以使用第三方客户端吗？

如果客户端支持自定义 OpenAI 兼容 Base URL，就填入组织提供的地址、Key 与模型 id；Key 只能保存在该客户端的私有配置中。

为什么模型名称会调用失败？

产品名称不是 API 标识。重新执行 GET /v1/models，只使用当前 Key 返回的准确 id。

04

用量与计费

在哪里查看用量和费用？

请向发放 Key 的组织确认适用的看板或报表流程。价格、额度和费用处理方式由组织自行确定。

为什么 Token 用量可能与预估不同？

输入上下文、生成内容、工具定义和多轮历史都会改变一次请求的总 Token 数。

如何隔离不同应用或团队？

请让凭据发放方按使用场景配置合适的凭据或访问范围。除非组织明确允许，否则不要在人或应用之间共享 Key。

05

故障与支持

请求失败应该如何排查？

先核对完整的 Base URL、Authorization 请求头和准确模型 id，再对照上方故障排查说明后重试。

访问或模型问题该找谁？

联系发放 API Key 的组织或管理员。他们可以确认正确的接口地址、授权范围和当前 Key 可用的模型。

如何验证模型的高级能力？

先用非流式文本请求验证基础连通性，再针对当前 Key 可访问的准确模型 id 验证流式、工具、视觉、推理和上下文限制。