接入概览
++ 用户先在平台生成 API Key，再通过 OpenAI 兼容地址访问上游模型。站点实际域名、默认 Base URL、自定义端点由管理员在“系统设置 -> 通用设置”中维护，这个页面只负责给出固定的使用范式。 +
+
+
+
+
+ 认证方式
+所有请求统一使用 Authorization: Bearer YOUR_API_KEY。
+
+ 常用入口
+推荐默认 OpenAI 兼容路径：/v1/chat/completions。
+ 页面不直接写死你的正式域名。部署后建议把“文档链接”设置为完整地址，例如
+ https://your-domain.com/docs/api.html，这样头部文档按钮和自定义菜单都会跳转到这个静态页。
+ 接口路径
++ 下表给出常见兼容路径。默认情况下，站点会把这些路径代理到对应上游模型服务。 +
+
+
+
+ OpenAI 兼容
+
+ https://your-domain.com/v1/chat/completions
+
+ Gemini 兼容
+
+ https://your-domain.com/v1beta
+
+ Claude Code / Anthropic
+
+ https://your-domain.com
+
+ Antigravity 专用
+
+ https://your-domain.com/antigravity
+ HTTP 调用示例
++ 业务系统、脚本和第三方客户端优先使用 OpenAI 兼容格式，兼容性最好。 +
+
+
+
+ cURL: Chat Completions
+ /v1/chat/completions
+
+ curl https://your-domain.com/v1/chat/completions \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "model": "gpt-5.4",
+ "messages": [
+ {"role": "system", "content": "You are a helpful assistant."},
+ {"role": "user", "content": "请简要介绍这个 API 网关"}
+ ]
+ }'
+
+
+ cURL: 流式输出
+ "stream": true
+
+ curl https://your-domain.com/v1/chat/completions \
+ -H "Authorization: Bearer YOUR_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "model": "gpt-5.4",
+ "stream": true,
+ "messages": [
+ {"role": "user", "content": "生成一个三点行动计划"}
+ ]
+ }'SDK 示例
+
+ 只要 SDK 支持自定义 base_url 或 baseURL，通常都能平滑接入。
+
+
+
+
+
+ JavaScript
+ openai npm
+
+ import OpenAI from "openai";
+
+const client = new OpenAI({
+ apiKey: process.env.API_KEY,
+ baseURL: "https://your-domain.com/v1",
+});
+
+const res = await client.chat.completions.create({
+ model: "gpt-5.4",
+ messages: [{ role: "user", content: "Hello" }],
+});
+
+console.log(res.choices[0]?.message?.content);
+
+
+ Python
+ openai python
+
+ from openai import OpenAI
+
+client = OpenAI(
+ api_key="YOUR_API_KEY",
+ base_url="https://your-domain.com/v1",
+)
+
+res = client.chat.completions.create(
+ model="gpt-5.4",
+ messages=[{"role": "user", "content": "Hello"}],
+)
+
+print(res.choices[0].message.content)CLI 配置
++ 如果你的用户主要通过 Claude Code、Gemini CLI、Codex CLI 或 OpenCode 接入，可以直接参考下面的环境变量和配置示例。 +
+
+
+
+
+
+ Claude Code
+ Anthropic 风格
+
+ export ANTHROPIC_BASE_URL="https://your-domain.com"
+export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
+export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
+
+
+ Gemini CLI
+ Gemini 风格
+
+ export GOOGLE_GEMINI_BASE_URL="https://your-domain.com/v1beta"
+export GEMINI_API_KEY="YOUR_API_KEY"
+export GEMINI_MODEL="gemini-2.0-flash"
+
+
+ Codex CLI
+ ~/.codex/config.toml
+
+ model_provider = "OpenAI"
+model = "gpt-5.4"
+disable_response_storage = true
+network_access = "enabled"
+
+[model_providers.OpenAI]
+name = "OpenAI"
+base_url = "https://your-domain.com/v1"
+wire_api = "responses"
+requires_openai_auth = true
+
+
+ OpenCode
+ opencode.json
+
+ {
+ "provider": {
+ "openai": {
+ "options": {
+ "baseURL": "https://your-domain.com/v1",
+ "apiKey": "YOUR_API_KEY"
+ }
+ }
+ },
+ "model": "openai/gpt-5.4"
+}兼容格式
++ 这个站点本质上是统一网关，所以文档应重点说明“按什么协议接入”，而不是只强调某一家模型。 +
+
+
+
+
+
+ | 类型 | +适用场景 | +关键路径 / 变量 | +
|---|---|---|
| OpenAI Chat Completions | +网页、服务端、脚本、第三方 SDK | +/v1/chat/completions |
+
| Responses / Codex | +Codex CLI、支持 responses 的客户端 | +base_url=/v1 |
+
| Anthropic / Claude | +Claude Code | +ANTHROPIC_BASE_URL |
+
| Gemini | +Gemini CLI、Gemini 兼容调用 | +GOOGLE_GEMINI_BASE_URL |
+
常见问题
+
+
+
+
+
+ | 状态码 | +说明 | +
|---|---|
401 |
+ API Key 缺失、错误或已失效。先检查 Bearer Token。 | +
403 |
+ 密钥被禁用、IP 限制未通过，或当前分组无权限。 | +
404 |
+ 请求路径错误，常见于把 /v1、/v1beta 写错。 |
+
429 |
+ 触发速率限制或额度限制，可去 API Key 页面看用量窗口。 | +
5xx |
+ 网关或上游临时异常，建议稍后重试并检查后台账号状态。 | +
+ 如果你希望这个静态页显示你自己的域名、默认模型、品牌名，可以后续再把它改成读取运行时配置的版本。但按你当前要求，静态 HTML 更简单，也最适合挂到“文档链接”里。
+
+