模型指南 / GPT

GPT 使用指南

通过 Stellahub 的 OpenAI 兼容接口接入 GPT 客户端，再选择当前 API Key 返回的模型 ID。

OpenAI 兼容

所需接入信息Stellahub API Key · 交付的 Base URL · 模型 ID

01 查询模型 ID

模型可用性由当前 API Key 的授权决定。发送请求前，先查询 GET /v1/models：

GET /v1/models

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

只将返回的准确 id 复制到 STELLAHUB_MODEL。如果没有返回 GPT 条目，请联系发放 Key 的组织，不要猜测模型名称。

02 发送第一次请求

将 STELLAHUB_MODEL 设置为返回的模型 ID，然后选择一种客户端示例。

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
}'

文本对话使用 POST /v1/chat/completions。正式使用流式输出、工具调用、视觉、推理或上下文能力前，请按返回的模型 ID 分别验证。

GPT 可用性说明

请使用 Stellahub OpenAI 兼容网关，并以当前认证 API Key 返回的准确 GPT 模型 ID 为准。

先执行 GET /v1/models，并从响应中复制准确的 id。
工具调用、流式输出、视觉、推理和上下文限制取决于返回的模型 ID 以及组织授权。

遇到 401、403、429 或模型不可用？查看故障排查 →