sublb-demo

SubLB API 的公开 Demo 仓库，用一套 Base URL 演示 Grok、OpenAI、Gemini、Claude、DeepSeek 的常用接入方式。

这个仓库解决一个很具体的问题：接入方拿到 SubLB 分组 Key 后，应该调用哪个接口、填哪个模型、按什么字段解析响应。

Base URL：https://sub-lb.tap365.org
认证：Authorization: Bearer <YOUR_SUBLB_API_KEY>
完整文档：sublb_grok_openai_gemini_claude_deepseek_API文档.md
gpt-image-2 生图、修图、遮罩编辑专项：gpt-image-2使用指南.md
生图新手使用指南：生图新手使用指南.md
Turing / turing-sdk 使用指南：docs/turing-and-sdk-usage.md

Turing / turing-sdk 怎么选

这个仓库不只提供裸 API curl，也提供面向用户和开发者的 Turing 接入路径：

场景	推荐入口	说明
人工对话、临时排障、进入 TUI	`turing`	给人用的 Turing Code 入口，适合交互式问答和排障。
Grok 第二意见 / Grok 文本任务	`turinggrok`	Grok provider wrapper；当前文档口径要求走 OpenAI-compatible `chat/completions`。
DeepSeek 文本 / 读文件任务	`turingdeepseek`	DeepSeek provider wrapper；如果原始接口 405，优先检查 base URL 和 `/v1/chat/completions` 路径。
Node.js 服务、脚本、队列、Agent	`turing-sdk`	npm SDK，适合后端集成和自动化任务，不建议直接放浏览器前端暴露 key。
Agent 示例收集	`turing-sdk-agent-demo/`	已放入 query、stream、Grok、DeepSeek、最小 Agent loop、routing、evaluator-optimizer、orchestrator-workers、客服 Agent、法律 intake Agent、skill loader、MCP-style 工具 Agent 示例。

小白选择建议：

只是想打开一个像 Claude Code 一样的交互命令框：先装 turing，然后运行 turing。
想在终端直接用 Grok / DeepSeek：运行 turinggrok 或 turingdeepseek。
想把能力接到自己的 Node.js 项目、后端服务或 Agent：用 turing-sdk，先看 turing-sdk-agent-demo/README.md。应用可以把本地 skill 文本放进 turing-sdk 的 systemPrompt；MCP 建议先由应用层调用工具，再把工具结果交给 SDK。
配 key 时只放环境变量或本机配置文件，不要写进代码和 README。

Turing 文档维护要求

Turing 安装命令是用户可直接复制执行的公开命令，必须按真实可访问链接维护。

当前已验证可用：

curl -fsSL https://turing.tap365.org/v1.1.7/install.sh | bash
curl -fsSL https://turing.tap365.org/v1.1.7/setup-provider-wrappers.sh | bash

维护红线：

改版本号前必须先验证远端脚本返回 200，例如： curl --noproxy '*' -fsSIL https://turing.tap365.org/vX.Y.Z/install.sh
install.sh 和 setup-provider-wrappers.sh 都验证通过后，才能写入 README / docs / 安装页。
禁止把未发布、返回 404、或只凭本地版本猜出来的安装链接写进用户可见文档。

一张图看懂

拿到 SubLB 分组 Key
└── 先确认 Key 属于哪个后台分组
    ├── spark / start / pro / ultra / Standard / GPT basic -> OpenAI-compatible
    │   └── /v1/chat/completions 或 /v1/responses
    ├── DeepSeek Basic / deepseek -> DeepSeek OpenAI-compatible
    │   └── /v1/chat/completions 或 /v1/responses
    ├── Grok 文本和图片 / Grok-codex 文图统一 -> Grok 文本和图片
    │   └── /v1/chat/completions 或 /v1/images/generations
    ├── open-img分组包月 -> OpenAI 图片
    │   └── /v1/images/generations 或 /v1/images/edits
    ├── claudecode特价 -> Claude Messages / Claude Fable 5
    │   └── /v1/messages；claude-fable-5 也支持 /v1/responses 非流式 JSON
    └── gemini（文本和图片） -> Gemini 原生
        └── /v1beta/models/{model}:generateContent

一个 Key 只代表一个后台分组的权限。不要按“全平台万能 Key”理解。

快速开始

复制环境变量模板：

cp .env.example .env

编辑 .env：

SUBLB_BASE_URL="https://sub-lb.tap365.org"
SUBLB_API_KEY="your_api_key_here"
SUBLB_MODEL="deepseek-v4-flash"

导入环境变量：

set -a
source .env
set +a

不要把真实密钥提交到 GitHub。

当前接入口径

测试日期：2026-06-10

文档版本：v4.1

后台分组	适合做什么	推荐接口	推荐模型	本轮 smoke
`spark`	GPT PRO+GPT plus 轻量入门档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`start`	GPT PRO+GPT plus 稳定入门档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`pro`	GPT PRO+GPT plus 进阶生产档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`ultra`	GPT PRO+GPT plus 旗舰稳定档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`Standard`	GPT PRO+GPT plus 主力档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`GPT basic`	gpt plus 普通入门档	`/v1/chat/completions`、`/v1/responses`	`gpt-5.5`，也可按 `/v1/models` 选择 GPT/Codex 系列	chat、responses 通过
`DeepSeek Basic`	DeepSeek 通用接入	`/v1/chat/completions`、`/v1/responses`	`deepseek-v4-flash`、`deepseek-v4-pro`	chat 两个模型通过；responses flash 通过
`deepseek`	DeepSeek 按量测试	`/v1/chat/completions`、`/v1/responses`	`deepseek-v4-pro`	responses pro 通过；其他本轮超时
`Grok 文本和图片`	Grok 文本、Grok 生图	`/v1/chat/completions`、`/v1/images/generations`	`grok-4.1-fast`、`grok-imagine-1.0`	文本通过
`Grok-codex 文图统一月订阅20260430(普通)`	Grok 文图普通套餐	`/v1/chat/completions`、`/v1/images/generations`	`grok-4.1-fast`、`grok-imagine-1.0`	文本通过
`Grok-codex 文图统一月订阅20260430(高级)`	Grok 文图高级套餐	`/v1/chat/completions`、`/v1/images/generations`	`grok-4.1-fast`、`grok-imagine-1.0`	文本通过
`open-img分组包月`	OpenAI 生图、图片编辑	`/v1/images/generations`、`/v1/images/edits`	`gpt-image-2`	本轮未测，见生图专项文档
`claudecode特价`	Claude 原生 Messages、Claude Fable 5	`/v1/messages`；`/v1/responses` 非流式 JSON	`claude-fable-5`、`claude-haiku-4-5-20251001`、`claude-opus-4-6/4-7/4-8`、`claude-sonnet-4-6`	`/v1/messages` 非流式 6 个模型通过；`claude-fable-5` `/v1/messages` stream 通过；`/v1/responses` 非流式通过
`gemini（文本和图片）`	Gemini 原生文本和图片	`/v1beta/models/{model}:generateContent`	`gemini-3-flash-preview` 等	本轮 503，无可用 Gemini 账号

super 本轮月额度超限，暂不作为 README 可用示例。Old*、用户勿选、自测、状态探针 分组也不作为 README 推荐接入示例。

最小 curl 示例

1. 列出模型

curl --noproxy '*' "$SUBLB_BASE_URL/v1/models" \
  -H "Authorization: Bearer $SUBLB_API_KEY" \
  -H "Accept: application/json"

2. DeepSeek 文本对话

curl --noproxy '*' "$SUBLB_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $SUBLB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "stream": false,
    "messages": [
      {"role": "user", "content": "只回复 SUBLB_OK"}
    ],
    "max_tokens": 32
  }'

读取：choices[0].message.content。

3. Responses

curl --noproxy '*' "$SUBLB_BASE_URL/v1/responses" \
  -H "Authorization: Bearer $SUBLB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "stream": false,
    "input": "只回复 SUBLB_RESPONSES_OK",
    "max_output_tokens": 32
  }'

读取：output_text 或 output[].content[].text。

4. Claude Messages

curl --noproxy '*' "$SUBLB_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $SUBLB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 64,
    "messages": [
      {"role": "user", "content": "只回复 SUBLB_CLAUDE_OK"}
    ]
  }'

读取：content[].text。

Claude Fable 5 与 Claude 4.x 模型

本轮重点按 Anthropic 原生 /v1/messages 验收，不把 /v1/chat/completions 作为 Claude 默认接入口径。

模型	`/v1/messages` 非流式	备注
`claude-fable-5`	200，返回 `pong`	支持 `/v1/messages` stream；支持 `/v1/responses` 非流式 JSON
`claude-haiku-4-5-20251001`	200，返回 `pong`	-
`claude-opus-4-6`	200，返回 `pong`	-
`claude-opus-4-7`	200，返回 `pong`	-
`claude-opus-4-8`	200，返回 `pong`	-
`claude-sonnet-4-6`	200，返回 `pong`	-

接口边界：

/v1/messages：支持非流式；claude-fable-5 流式实测 200，返回标准 SSE 事件。
/v1/responses：claude-fable-5 支持非流式 JSON，实测 200；status=incomplete 可能只是 max_output_tokens 太小。
/v1/responses + stream:true：本轮未通过，不建议作为默认写法。
/v1/complete：本轮 404，不支持。
/v1/response：本轮 404，不支持。
网络提示：如本机代理污染，可用 --noproxy '*'；如网络环境必须代理，先确认本机代理链路可用。

5. Gemini 原生文本

curl --noproxy '*' "$SUBLB_BASE_URL/v1beta/models/gemini-3-flash-preview:generateContent" \
  -H "x-goog-api-key: $SUBLB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "只回复 SUBLB_GEMINI_OK"}]}
    ],
    "generationConfig": {"maxOutputTokens": 32, "temperature": 0}
  }'

读取：candidates[0].content.parts[].text。注意：本轮 gemini（文本和图片） 返回 503，无可用 Gemini 账号，当前不写成已通过。

6. 图片生成

curl --noproxy '*' "$SUBLB_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer $SUBLB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "White background, simple blue letter O icon",
    "size": "1024x1024",
    "n": 1
  }'

OpenAI 图片通常读取 data[0].b64_json；Grok 图片通常读取 data[0].url。

sublb-demo/
├── .env.example
├── README.md
├── sublb_grok_openai_gemini_claude_deepseek_API文档.md
├── gpt-image-2使用指南.md
├── Sublb生图对外API文档.md
├── QA常见问题.md
├── 第三方客户端问题汇总.md
├── examples/
│   ├── curl/
│   └── python/
├── turing-sdk-agent-demo/
│   ├── README.md
│   └── examples/
└── tests/
    └── sublb_openai_compatible_smoke.hurl

文档补充规则

新模型先跑真实业务接口，再写进推荐清单。
/v1/models 可枚举不等于业务接口可用。
对外文档不写内部 Key、账号、测试产物路径或后台详情。
生图客户端同时兼容 data[0].url 和 data[0].b64_json。
Gemini 当前优先按 Google 原生 /v1beta 文档接入；未列出的 Gemini 模型不在当前推荐范围内。

License

MIT

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

sublb-demo

Turing / turing-sdk 怎么选

Turing 文档维护要求

一张图看懂

快速开始

当前接入口径

最小 curl 示例

1. 列出模型

2. DeepSeek 文本对话

3. Responses

4. Claude Messages

Claude Fable 5 与 Claude 4.x 模型

5. Gemini 原生文本

6. 图片生成

目录

文档补充规则

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 33 Commits
docs		docs
examples		examples
grok		grok
openai		openai
test_runs		test_runs
tests		tests
turing-agent-sdk		turing-agent-sdk
turing-sdk-agent-demo		turing-sdk-agent-demo
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
QA常见问题.md		QA常见问题.md
README.md		README.md
Sublb生图对外API文档.md		Sublb生图对外API文档.md
gpt-image-2使用指南.md		gpt-image-2使用指南.md
sublb_grok_openai_gemini_claude_API文档.md		sublb_grok_openai_gemini_claude_API文档.md
sublb_grok_openai_gemini_claude_deepseek_API文档.md		sublb_grok_openai_gemini_claude_deepseek_API文档.md
上游grok视频支持测试_2026-04-26.md		上游grok视频支持测试_2026-04-26.md
生图新手使用指南.md		生图新手使用指南.md
第三方客户端问题汇总.md		第三方客户端问题汇总.md

Folders and files

Latest commit

History

Repository files navigation

sublb-demo

Turing / turing-sdk 怎么选

Turing 文档维护要求

一张图看懂

快速开始

当前接入口径

最小 curl 示例

1. 列出模型

2. DeepSeek 文本对话

3. Responses

4. Claude Messages

Claude Fable 5 与 Claude 4.x 模型

5. Gemini 原生文本

6. 图片生成

目录

文档补充规则

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages