大模型 API 使用与接入指南

🔗 Gemini 原生网关 (Base URL):
https://api.api48.com

* 推荐：用于支持原生 Gemini 节点的服务或代码直连调用。

🔗 OpenAI 兼容网关 (Base URL):
https://openai.api48.com/v1

* 兼容：用于仅支持 OpenAI 协议的各类主流客户端。配置时，模型名称依旧填写 Gemini 模型名即可（如 gemini-2.5-flash）。

📱 主流客户端接入配置

🍻 酒馆 (SillyTavern) 配置方法 (支持两种模式)

方式一：使用 OpenAI 兼容模式（推荐，免改代码直接连）

启动 SillyTavern，进入顶部 API 连接设置。
将 API / 聊天补全来源 选择为 自定义(兼容OpenAI)。
API URL (Base URL): 填入 https://openai.api48.com/v1
API Key: 填入本站控制台生成的 api48- 密钥。
模型 (Model): 选择自定义模型或手动输入（如 gemini-2.5-flash 或 gemini-3.1-pro-preview）。点击连接即可。

方式二：使用 Gemini 原生模式（需要修改本地文件）

使用记事本或Notepad++打开本地配置文件：

在 SillyTavern\src\endpoints\google.js 文件中，找到：
const API_MAKERSUITE = 'https://generativelanguage.googleapis.com';
将其修改为：
const API_MAKERSUITE = 'https://api.api48.com';
然后在 SillyTavern\src\endpoints\backends\chat-completions.js 找到相同的代码同上修改。
修改完成后重新启动 SillyTavern。

启动后在连接模型配置中，将 聊天补全来源 选择为 Google AI studio。然后选择一个本站支持的模型，将您在本站控制台获得的key填入API密钥处即可连接。

🦞 小龙虾 (Openclaw) 配置方法

请按照以下步骤在小龙虾客户端中完成模型配置：

在左侧菜单点击 设置AI与Agent，进入 Models 页面。
在 Custom entries 部分点击 Add Entry 添加模组。
进行以下基础设置：
- 将最上面默认名称 custom 改为 api48
- Model Provider API Adapter： 选 google generative ai
- Model Provider API Key： 填写您在本站控制台生成的 API Key（以 api48- 开头）
- Model Provider Auth Mode： 选 api key
- Model Provider Base URL： 填写 https://api.api48.com/v1beta
往下滚动到 Model Provider Model List 部分，点击 Add 添加模型：
- Api： 选择 google generative ai
- Base Url： 填写 https://api.api48.com/v1beta
- ID 和 Name： 填写您需要使用的模型标识，如 gemini-2.5-flash 或 gemini-flash-latest
填写完成后，务必点击 Save 保存配置。
向左切换一个标签页到 Agents 页面，往下找到 Model 空格代码框。将其中的包含 primary 的这句代码修改为：
"primary": "api48/gemini-2.5-flash"
* 注意：这里的两个名称（模组名 api48 和模型名 gemini-2.5-flash）需要与刚刚修改的地方对应。
同样保存设置。至此小龙虾主模型设置全部完成。点击最上面的聊天界面即可进行测试。

💬 ChatBox / NextChat 配置 (支持两种模式)

我们的网关目前同时支持 Gemini 原生协议 和 OpenAI 兼容协议，您可以根据客户端的支持情况选择：

方式一：使用 Gemini 原生模式（推荐）

在设置-模型提供方中选择 Gemini / Google AI 服务商。
API 密钥: 填入您在控制台生成的 api48- 密钥。
API 域名 (Base URL / Endpoint): 填入 https://api.api48.com。

方式二：使用 OpenAI 兼容模式

在设置-模型提供方中选择 OpenAI API 服务商。
API 密钥: 填入您在控制台生成的 api48- 密钥。
API 域名 (Base URL / Endpoint): 填入 https://openai.api48.com/v1。
模型 (Model): 手动添加或输入想要使用的模型，例如：gemini-2.5-flash 或 gemini-3.1-pro-preview。

💻 IDE 与 AI 编程辅助插件接入 (VS Code / JetBrains)

我们的接口完美支持各类支持 自定义原生 Gemini 节点 的主流编程辅助插件，助您实现极速的沉浸式 AI 编程。请注意：在配置时，服务商（Provider）务必选择 Google Gemini 或 Google AI Studio，切勿选择 OpenAI 兼容模式。

方案一：Continue.dev (强烈推荐，支持 VS Code / JetBrains)

打开 Continue 的 config.json 配置文件，在 models 数组中添加如下配置：

                    "models": [
                    {
                    "title": "API48 Gemini 2.5 Pro",
                    "provider": "gemini",
                    "model": "gemini-2.5-pro",
                    "apiKey": "api48-您的专属API_KEY",
                    "apiBase": "https://api.api48.com"
                    }
                    ]
                

方案二：Cline / Roo Code (VS Code 顶流自动编程插件)

API Provider (服务商): 选择 Google Gemini。
API Key: 填入您在控制台生成的 api48- 密钥。
Base URL (接口地址): 填入 https://api.api48.com。
Model ID: 手动输入或选择 gemini-3.1-pro-preview 或 gemini-2.5-flash 等您需要的模型。

👨‍💻 开发者原生 API 调用指南

我们的网关 100% 还原并兼容 Google 官方的 API 规范。由于大陆网络环境受限，您可以直接复制以下代码，将官方文档中的 generativelanguage.googleapis.com 替换为我们的网关地址即可无缝开发。

Bash / cURL

                curl "https://api.api48.com/v1beta/models/gemini-2.5-flash:generateContent" \
                -H 'Content-Type: application/json' \
                -H 'x-goog-api-key: api48-您的专属API_KEY' \
                -d '{
                "contents": [{
                "parts":[{"text": "你好！请用一句话介绍你自己。"}]
                }]
                }'
            

Python (Requests原生直连，无需复杂SDK配置)

                import requests
                import json

                url = "https://api.api48.com/v1beta/models/gemini-2.5-flash:generateContent"
                headers = {
                "Content-Type": "application/json",
                "x-goog-api-key": "api48-您的专属API_KEY"
                }
                data = {
                "contents": [{
                "parts": [{"text": "你好！请用一句话介绍你自己。"}]
                }]
                }

                response = requests.post(url, headers=headers, data=json.dumps(data))
                print(response.json())
            

Node.js (Fetch原生直连)

                const url = "https://api.api48.com/v1beta/models/gemini-2.5-flash:generateContent";
                const apiKey = "api48-您的专属API_KEY";

                fetch(url, {
                method: "POST",
                headers: {
                "Content-Type": "application/json",
                "x-goog-api-key": apiKey
                },
                body: JSON.stringify({
                contents: [{
                parts: [{ text: "你好！请用一句话介绍你自己。" }]
                }]
                })
                })
                .then(response => response.json())
                .then(data => console.log(JSON.stringify(data, null, 2)))
                .catch(error => console.error("Error:", error));
            

* 更多进阶功能（如流式输出 Stream、多模态视觉传图、Function Calling）等结构，请完全遵循 Google Gemini 官方标准构造 Request Body。