模型 API（OpenAI 兼容）

使用 OpenAI 兼容协议调用 SSH Good。端点：https://api.sshgoodapi.cc/v1。

Base URLhttps://api.sshgoodapi.cc/v1

鉴权与请求头

统一 Bearer 鉴权

http

Authorization: Bearer sk-xxx
Content-Type: application/json

将 sk-xxx 替换为控制台真实密钥。不要把 Key 放进 URL 查询参数。

列出模型

bash

curl https://api.sshgoodapi.cc/v1/models \
  -H "Authorization: Bearer sk-xxx"

Chat Completions

curl 示例

bash

curl https://api.sshgoodapi.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "用一句话介绍 SSH Good API"}
    ],
    "temperature": 0.7
  }'

model 请换成控制台中的实际 ID；也可先参考模型 API 中的 GET /v1/models 查看。

Python（官方 openai SDK）

python

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://api.sshgoodapi.cc/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "ping"}],
)
print(resp.choices[0].message.content)

TypeScript / Node

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxx",
  baseURL: "https://api.sshgoodapi.cc/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "ping" }],
});
console.log(resp.choices[0].message.content);

图像生成示例（若模型已开放）

部分兼容网关暴露 /images/generations。若你的套餐包含图像模型，可参考：

bash

curl https://api.sshgoodapi.cc/v1/images/generations \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "a minimal green terminal icon",
    "size": "1024x1024"
  }'

说明：若返回模型不可用或 404，表示当前账号未开通该能力，请改用控制台中已开通的聊天模型。

错误码与限流

401：Key 错误、过期或未带 Bearer。
403：账号无权限访问该模型或能力未开通。
404：路径写错（少了/多了 /v1）或模型 ID 不存在。
429：触发速率限制，请降低并发并做指数退避重试。
5xx：上游或网关短暂异常，稍后重试并避免密集连打。

更多场景见答疑 FAQ。