GLOUTH LINK · API DOCS

一个 Base URL,
两种协议,所有模型。

Glouth Link 是双协议兼容的 LLM 网关。同一个 Base URL 同时接受 Chat Completions / Responses 和 Messages 两种协议;同一把 API Key 可以驱动主流的对话 SDK、消息 SDK、以及各类 AI 命令行工具等任何兼容客户端。

快速上手

三步:创建 Key → 设置 Base URL → 用熟悉的 SDK 调用。下面四种写法任选其一:

1. 登录 /link/console，创建 API Key（完整 Key 只显示一次）。
2. 把 Key 放进服务端环境变量，例如 GLOUTH_LINK_KEY；不要写进前端代码。
3. Base URL 固定为 https://www.glouth.com/link/v1，模型先用默认的 gpt-6.1-sol。
4. 跑通第一条请求后，再按需要换模型 / 开流式 / 加 tools。

curl https://www.glouth.com/link/v1/chat/completions \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role":"user","content":"Hello"}]
  }'

认证

支持两种认证方式,任选其一:

方式一:Bearer Token(Authorization 头)

Authorization: Bearer sk-glouth-XXXXXXXXXXXXXXXXXX

方式二:x-api-key 头

x-api-key: sk-glouth-XXXXXXXXXXXXXXXXXX

注:Glouth Link 自动识别两种 header。若同时传,优先 Authorization。

Base URL 与协议

所有端点的 Base URL 是同一个:

https://www.glouth.com/link/v1

协议自动判定

• 请求带 anthropic-version 或 x-api-key 头 → Messages 协议
• 请求 body 含 system 字段、或 content block 数组 → Messages 协议
• 其他情况 → Chat Completions 协议

所有端点

下面列表是当前支持的端点。点击跳详细参数。

• POST /chat/completions — 对话生成
• POST /responses — Responses API
• POST /messages — Anthropic Messages API
• POST /images/generations — 图片生成
• POST /images/edits — 图片编辑
• GET /models — 模型列表
• GET /dashboard/billing/usage — 账单与用量

模型一览

默认推荐 gpt-6.1-sol：日常对话、代码、长文和专业工作都够用，价格也最平衡。实时价格 → /link#pricing（从 DB 实时读）。
可用模型 → GET /models（按 Key 权限筛选）。

价格由 /api/link/pricing 实时读取，调价后刷新本页即可，不需要重新构建文档。5.4 / 5.4-mini / 5.2 已下架展示，需要旧版可联系客服；gpt-6-luna / gpt-5.6-luna 上游通道维护中，已临时下架。

怎么选

• 默认 / 大多数任务：gpt-6.1-sol，日常、代码、长文、专业工作都够用。
• 最难的任务：gpt-6-astra，深度研究、复杂代码、长链路 Agent，价格最高。
• 高并发 / 批量：gpt-6-sol，稳定通用，适合分类、抽取、批量文案。
• 旧项目兼容：gpt-5.5、gpt-5.6-sol 继续可用，不需要为了换模型改代码。
• 图片：gpt-image-2.5-sunburst（精度优先）或 flare（速度优先），¥0.2/张。

所有上架文本模型都支持流式与 tools；GPT-6 / GPT-5.6 系列支持 reasoning 与图片输入（vision）。

OpenAI Chat Completions 兼容端点,接收聊天历史返回模型回复。支持流式、视觉、推理强度、函数调用。

参数

请求示例

curl https://www.glouth.com/link/v1/chat/completions \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning_effort": "medium",
    "messages": [
      {"role":"system","content":"You are a precise assistant."},
      {"role":"user","content":"What is 23 * 17?"}
    ]
  }'

响应示例

{
  "id": "chatcmpl_...",
  "object": "chat.completion",
  "model": "gpt-6.1-sol",
  "choices": [{
    "index": 0,
    "message": {"role":"assistant","content":"391"},
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 34,
    "completion_tokens": 24,
    "total_tokens": 58,
    "prompt_tokens_details": {"cached_tokens": 0},
    "completion_tokens_details": {"reasoning_tokens": 17}
  }
}

OpenAI 新版 Responses 端点,通过 input 字段提交内容,适合长上下文与会话状态托管类用法。所有 chat/completions 的特性同样适用。

参数

请求示例

curl https://www.glouth.com/link/v1/responses \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "用一句话介绍 Glouth Link。"
  }'

响应示例

{
  "id": "resp_...",
  "object": "response",
  "output": [{"type":"message","content":[{"type":"output_text","text":"..."}]}],
  "usage": {"input_tokens": 12, "output_tokens": 21}
}

完全兼容 Anthropic /v1/messages 接口形态。请求头带 anthropic-version 或 x-api-key,或 body 含 system/content block 时,主站自动走 Anthropic 协议路径。

参数

请求示例

curl https://www.glouth.com/link/v1/messages \
  -H "x-api-key: $GLOUTH_LINK_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "max_tokens": 1024,
    "thinking": {"type":"enabled","budget_tokens":4000},
    "messages": [
      {"role":"user","content":"What is 25*4?"}
    ]
  }'

响应示例

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "gpt-6.1-sol",
  "content": [{"type":"text","text":"100"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 26, "output_tokens": 18}
}

调用 gpt-image-2.5-sunburst 模型从文本提示生成图片。响应中返回 b64_json 或 url。按请求计固定单价。

参数

请求示例

curl https://www.glouth.com/link/v1/images/generations \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "A minimalist green leaf on white background",
    "size": "1024x1024",
    "n": 1
  }'

响应示例

{
  "created": 1778561900,
  "data": [{
    "b64_json": "iVBORw0KGgoAAAA..."
  }]
}

基于现有图片做编辑/重绘。输入图片以 base64 形式放入 JSON body(无需 multipart),与 prompt 一起提交。

参数

请求示例

curl https://www.glouth.com/link/v1/images/edits \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "Add soft snow falling in front of the scene",
    "image_data_url": "data:image/png;base64,iVBORw0KGgo...",
    "size": "1024x1024"
  }'

响应示例

{"created": ..., "data": [{"b64_json": "..."}]}

返回当前 Key 可见的模型集合。若 Key 设置了 allowed_models 白名单,响应自动收窄。默认推荐 gpt-6.1-sol。

请求示例

curl https://www.glouth.com/link/v1/models \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY"

响应示例

{
  "object": "list",
  "data": [
    {"id":"gpt-6.1-sol","object":"model","created":1778000000,"owned_by":"glouth"},
    {"id":"gpt-6-astra","object":"model","created":1778000000,"owned_by":"glouth"},
    {"id":"gpt-6-sol","object":"model","created":1778000000,"owned_by":"glouth"},
    {"id":"gpt-5.6-sol","object":"model","created":1778000000,"owned_by":"glouth"},
    {"id":"gpt-image-2.5-sunburst","object":"model","created":1778000000,"owned_by":"glouth"},
    ...
  ]
}

查询当前 Key 关联的余额、硬额度、今日 / 本月消耗、近 30 天模型占比。响应字段稳定。别名 GET /key/usage。

请求示例

curl https://www.glouth.com/link/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $GLOUTH_LINK_KEY"

响应示例

{
  "balance_cents": 12345,
  "hard_limit_cents": 100000,
  "used_cents": {"today": 482, "this_month": 4152, "this_30d": 5811},
  "request_count": 1234,
  "by_model_30d": [{"model":"gpt-6.1-sol","requests":612,"cost_cents":2103}, ...]
}

推理程度调节(reasoning_effort)

更深推理 → 答案更稳但更慢更贵。Glouth 支持 4 档:low / medium / high / xhigh(后者为 Glouth 扩展)。

Chat Completions 协议

{
  "model": "gpt-6.1-sol",
  "reasoning_effort": "high",
  "messages": [...]
}

Messages 协议

通过 thinking.budget_tokens 按预算自动映射:

{
  "model": "gpt-6-astra",
  "thinking": {"type": "enabled", "budget_tokens": 4000},
  "messages": [...]
}

# 自动映射:
# <2000  → low
# <8000  → medium
# <16000 → high
# ≥16000 → xhigh

快速模式

2 个降延迟的方法:

方案一:设 reasoning_effort: "low"

不改模型,只降推理深度。

方案二:透传 service_tier

{"model": "gpt-6.1-sol", "service_tier": "flex", "messages": [...]}

图片输入(Vision)

Chat Completions 风格

{
  "model": "gpt-6.1-sol",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "这是什么?"},
      {"type": "image_url", "image_url": {"url": "https://.../cat.jpg"}}
    ]
  }]
}

Messages 风格

{
  "model": "gpt-6-astra",
  "max_tokens": 512,
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "这是什么?"},
      {"type": "image", "source": {"type": "base64", "media_type": "image/jpeg", "data": "..."}}
    ]
  }]
}

流式 SSE

所有对话端点支持 stream:true。请求 Accept: text/event-stream,响应按 SSE 分帧。

Chat Completions 风格响应帧

data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"content":"H"}}]}

data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"content":"i"}}]}

data: {"id":"...","object":"chat.completion.chunk","choices":[{"finish_reason":"stop","delta":{}}],"usage":{...}}

data: [DONE]

Messages 风格响应帧

event: message_start
data: {"type":"message_start","message":{...}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"H"}}

...

event: message_stop
data: {"type":"message_stop"}

提示缓存(Prompt Caching)

常用系统 prompt 自动被上游缓存,后续命中价格降至 input 的 10%。Glouth 不需要你做任何特殊设置 — 上游(OpenAI / Anthropic)自动判定。

响应 usage.prompt_tokens_details.cached_tokens 字段告诉你这次命中了多少 cache。

函数调用 / Tools

OpenAI 风格

{
  "model": "gpt-6.1-sol",
  "messages": [...],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "获取某地天气",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type":"string"}}
      }
    }
  }],
  "tool_choice": "auto"
}

Anthropic 风格

{
  "model": "gpt-6.1-sol",
  "max_tokens": 512,
  "messages": [...],
  "tools": [{
    "name": "get_weather",
    "description": "获取某地天气",
    "input_schema": {"type":"object","properties":{"city":{"type":"string"}}}
  }]
}

Claude Code（兼容模式）

用 Glouth Link 的 Messages 协议兼容层接 Claude Code：RMB 充值、国内直连。注意：上游实际执行的是 GPT-6.1 Sol / GPT-5.6 系列，Claude 模型名仅做兼容映射，不是 Anthropic 官方模型。

建议配置

# 一键安装(macOS / Linux)
curl -fsSL https://www.glouth.com/link/claude/setup.sh | sh

# 或手动配置 ~/.claude/settings.json
{
  "apiKeyHelper": "echo \"$GLOUTH_LINK_KEY\"",
  "env": {
    "ANTHROPIC_API_KEY": "$GLOUTH_LINK_KEY",
    "ANTHROPIC_BASE_URL": "https://www.glouth.com/link/v1"
  }
}

OpenAI SDK

# Node.js
npm install openai

# Python
pip install openai

Node.js / TypeScript

import OpenAI from 'openai'
const client = new OpenAI({
  apiKey: process.env.GLOUTH_LINK_KEY,
  baseURL: 'https://www.glouth.com/link/v1',
})

Python

from openai import OpenAI
client = OpenAI(
    api_key=os.environ['GLOUTH_LINK_KEY'],
    base_url='https://www.glouth.com/link/v1',
)

Anthropic SDK（Messages 兼容）

Anthropic SDK 可以直接指向本网关；模型名请用 Glouth 的 gpt-6.1-sol 等，或使用 Claude 名称走映射。

pip install anthropic

from anthropic import Anthropic
client = Anthropic(
    api_key=os.environ['GLOUTH_LINK_KEY'],
    base_url='https://www.glouth.com/link/v1',
)

Cursor / Cline / Continue

这些工具都支持 OpenAI-compatible 的自定义端点。选 “OpenAI Compatible / Custom OpenAI”，填下面三项即可：

Base URL: https://www.glouth.com/link/v1
API Key:  sk-glouth-...
Model:    gpt-6.1-sol

• 不要选 “OpenAI 官方登录” 或 “Anthropic 官方”，否则会绕开 Glouth 的 Key。
• 如果工具要求填写完整 /chat/completions URL，请用 https://www.glouth.com/link/v1/chat/completions。
• 写代码优先 gpt-6.1-sol；更难的仓库级任务再切 gpt-6-astra。

限流、并发与配额

每个 Key 可以在 /link/console 单独配置，不是全站固定值；下面的“默认”是未配置时的行为。

触发限制时返回 429，优先看 Retry-After 和错误 code：

HTTP/1.1 429 Too Many Requests
Retry-After: 2

{"error":{"type":"rate_limit_error","code":"rate_limit_exceeded","message":"..."}}

• RPM / 并发：指数退避（1s → 2s → 4s，加随机抖动），不要立即无限重试。
• 余额 / 硬额度：充值或调高 Key 的 hard limit；余额不足不是重试能解决的。
• 模型 / 端点白名单：通常是 403 或 404，先 GET /models 确认当前 Key 可见范围。
• 持续 429 时，把 X-Glouth-Request-ID 和发生时间一起发客服，方便定位是 Key 级还是平台级。

安全与密钥

• 只在服务端使用：sk-glouth-... 不要写进网页、App、浏览器插件或公开仓库。
• 一个项目一把 Key：按项目 / 环境拆 Key，泄露时只吊销一把，不影響其它业务。
• 最小权限：用 allowed_models / allowed_endpoints 限制 Key 能调用的模型和端点。
• 设上限：给 Key 设 hard limit 和过期时间；测试 Key 用完即删。
• 轮换：怀疑泄露时先在 Console 吊销旧 Key，再创建新 Key；不要只改代码里的字符串。
• 日志脱敏：不要把 Authorization 头、完整 Key 或用户 prompt 原样打进日志。
• 不要放 URL query：Key 只走 Authorization: Bearer 或 x-api-key，避免被网关/代理日志记录。

常见问题

支持 OpenAI SDK 吗？

支持。把 baseURL 改成 https://www.glouth.com/link/v1、apiKey 换成 Glouth Key 即可，模型名用本页目录里的 key。

默认用哪个模型？

gpt-6.1-sol。除非你有明确理由，否则先用它；最难的任务再切 gpt-6-astra。

有 Claude / Gemini 吗？

当前上游目录没有原生 Claude / Gemini。Messages 协议和 Claude 名称是兼容映射，实际执行的是 GPT-6.1 / GPT-5.6；需要原生 Claude / Gemini 的场景不要按本目录选型。

为什么 GET /models 少了一个模型？

可能是模型已下架、当前 Key 的 allowed_models 白名单没开，或该模型暂时没有可用线路。以接口返回和 定价页 为准。

图片怎么计费？

当前 gpt-image-2 / gpt-image-2.5 都是 ¥0.2/张，按平均质量估算；实际扣费以账单为准。

流式 / tools / 图片输入支持吗？

上架文本模型支持流式与 tools；GPT-6 / GPT-5.6 支持 reasoning 与 vision。具体字段见下方对应端点。

余额和用量在哪看？

Console 的用量页，或调用 GET /dashboard/billing/usage（别名 /key/usage）。

更新日志

2026-10-20

• 默认模型切到 gpt-6.1-sol；新增 gpt-6-astra、gpt-6-sol、gpt-6-luna。
• 保留 gpt-5.6-sol / terra / luna、gpt-5.5；下架 5.4 / 5.4-mini / 5.2 展示。
• 移除 codex 专线及对应文档；Embeddings / Rerank 暂无上架模型，文档入口下线。
• 价格改为官方 USD × 6.72 × 0.2，向上取整到 0.1 元；图片 ¥0.2/张。
• 文档升级：模型选型、限流、安全、FAQ、IDE 集成。

错误码

提工单请把响应头里的 X-Glouth-Request-ID 一并发给客服。