ONLINE · OPENAI COMPATIBLE

一看就会的 Summer API 接入指南

不用理解复杂协议。你只需要记住三件事:接口地址填 https://summerapi.com/v1,密钥填自己的 sk- 令牌,模型名按后台开放列表填写。

https://summerapi.com/v1
Authorization: Bearer sk-你的令牌

三步接入

1
创建令牌

登录 Summer API 面板,进入“令牌”,新建一个 sk- 开头的 API Key。

2
填写接口地址

客户端选择 OpenAI 或 OpenAI Compatible,Base URL 填 https://summerapi.com/v1

3
选择模型测试

模型名填后台开放的名称,例如 gpt-4o-mini。保存后发一句“你好”测试。

直接复制这些配置

你看到的字段应该填写说明
Provider / 服务商OpenAI Compatible也可能叫“自定义 OpenAI”。
API Host / Base URLhttps://summerapi.com/v1一般不要漏掉末尾的 /v1
API Keysk-你的令牌每个用户用自己的令牌,不要共用管理员密钥。
Model / 模型gpt-4o-mini不知道选哪个时,先用轻量模型测试。

常见客户端怎么填

ChatBox NextChat LobeChat Cursor Cherry Studio
ChatBox / Cherry Studio

服务商选 OpenAI 或 OpenAI Compatible。API 地址填 https://summerapi.com/v1,密钥填自己的 sk-

NextChat / LobeChat

开启自定义接口或代理地址。接口地址填 https://summerapi.com/v1,再手动添加模型名。

Cursor

启用 OpenAI API Key,在 Override OpenAI Base URL 填 https://summerapi.com/v1

其他工具

只要支持 OpenAI Compatible,就按 Base URL、API Key、Model 三项填写。

New API 后台怎么配置

这一段给站长或管理员看。普通用户不需要上游密钥,只需要你分配的令牌。

配置项怎么填
渠道类型按上游选择,例如 OpenAI、Azure OpenAI、Anthropic、Gemini、OpenRouter 或自定义渠道。
渠道地址填写上游 Base URL。OpenAI 官方通常留空或填 https://api.openai.com
密钥填写上游 API Key,一行一个。不要发给普通用户。
模型映射如果对外模型名和上游模型名不同,在渠道模型或模型重定向中配置。
额度和分组按用户套餐设置额度、倍率和可用模型,避免用户调用不可用模型。

开发者代码示例

curl 测试

curl https://summerapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好,介绍一下你自己"}
    ]
  }'

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的令牌",
  baseURL: "https://summerapi.com/v1"
});

const completion = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }]
});

console.log(completion.choices[0].message.content);

Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的令牌",
    base_url="https://summerapi.com/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)

print(completion.choices[0].message.content)

遇到报错先看这里

401 Unauthorized

API Key 错误、令牌被禁用、额度不足,或者请求头没有写 Bearer

模型不存在

模型名和后台不一致,或你的用户分组没有这个模型权限。

连接超时

检查网络、代理、域名和客户端是否能访问 https://summerapi.com/v1

不知道选哪个模型

先用 gpt-4o-mini 测试,确认可用后再切换更高规格模型。

安全提醒:不要把服务器 root 密码、数据库密码、上游 API Key 放进文档。普通用户只需要自己的 API 令牌。