三剪客 · a7w 全量协议桥

一行 base_url，把算力集市的全部能力接进你现有的 AI 项目。

🔑 API Key 说明（重要，请先读这一段）

本 Skill 不含任何 API Key，也不会替你使用任何人的 Key。

• 请到 算力集市 · api.a7w.cn 注册， 在「用户中心 → API 密钥」申请 你自己的 Key（需实名认证）
• 请勿使用他人分享的 Key —— 包括朋友给的、群里发的，以及本文档作者的
• 本 Skill 生成的配置与导入链接一律不含 Key；Key 只在你本机填写一次
• Key 等同于账户余额，不要写进代码、不要提交到 Git、不要发到聊天里
• 每个 Key 可单独设置消费上限（quota），建议按项目分配

一、你可能正卡在这里

你已经在用某个开源 AI 项目——Dify 做知识库、MoneyPrinterTurbo 批量出片、 VideoCaptioner 做字幕、ComfyUI 玩出图。现在想换成国产算力、一个 Key 通吃。

你把 base_url 改成算力集市，对话跑通了，然后：

• 点「生成配音」 → 报错
• 点「语音转字幕」 → 报错
• 点「生成图片」 → 报错

于是你以为「这个网关不支持」。

其实能力一直都在，只是协议对不上。 算力集市有两条入口：

模型网关   POST /api/v1/chat/completions    ← 真 OpenAI 兼容，客户端直接用 ✅
应用任务   POST /api/v1/apps/{app}/{code}   ← 自有异步协议，客户端不认  ❌

而开源生态只会说 OpenAI 那几种协议。中间缺一层翻译。

这个桥就是那层翻译。

二、它能做什么

装完这个桥，你的客户端什么都不用改，就能用上：

一句话：以前只能聊天的客户端，现在 TTS、ASR、出图全都能调。

三、三分钟上手

# 1) 启动（想双击运行：把 references/launcher.md 里的脚本存成 .cmd 即可）
python -X utf8 scripts/a7w_bridge.py --port 8788

启动后你会看到：

================================================================
  a7w-bridge —— 算力集市全量协议桥
================================================================
  上游       : https://api.a7w.cn
  API Key    : 已配置（sk-***）
  embedding  : 未配外挂（/v1/embeddings 返回 501 + 配置指引）
================================================================
  客户端 base_url   : http://127.0.0.1:8788/v1
  健康检查          : http://127.0.0.1:8788/health
  21 个应用全量透传 : http://127.0.0.1:8788/a7w/{app}/{code}
================================================================

# 2) 把你客户端的 base_url 改成它
base_url = http://127.0.0.1:8788/v1
api_key  = 任意值（桥会用本机 Key，也可在请求头自带）

就这两步。 原本报错的能力全部可用。

代码里怎么用

from openai import OpenAI
c = OpenAI(base_url="http://127.0.0.1:8788/v1", api_key="dummy")

# 对话
c.chat.completions.create(model="DeepSeek-V4-Flash",
                          messages=[{"role": "user", "content": "你好"}])

# 配音
c.audio.speech.create(model="s2-pro", voice="alloy", input="今天天气不错")

# 字幕（一条拿到 SRT，带时间轴）
r = c.audio.transcriptions.create(model="whisper-1", file=open("a.mp3","rb"),
                                  response_format="srt")
open("a.srt","w",encoding="utf-8").write(r)

# 出图
c.images.generate(model="nano-banana", prompt="一只在窗台上晒太阳的橘猫")

全量应用（21 个都走这个口）

curl -s http://127.0.0.1:8788/a7w/voice_tts/list_voices \
     -H 'Content-Type: application/json' -d '{}'

# 加 "_wait": true 自动轮询到任务完成
curl -s http://127.0.0.1:8788/a7w/flashvsr/submit \
     -H 'Content-Type: application/json' \
     -d '{"video_url":"https://...","_wait":true}'

四、实测：12/12 全通过

用真实 Key、真发请求，逐项验证：

随时自己复跑：

python -X utf8 scripts/test_bridge.py

五、支持的客户端与平台

凡是能改 base_url 的，都能接：

逐项目的具体改法见 references/integrate.md。

提示：桥自己实现了 /v1/*，所以 base_url 要带 /v1。 （直连算力集市网关时则相反——那是 sanjianke-chatbox 里讲的那个坑。）

六、embedding 外挂（可选增强）

算力集市聚焦在生成类能力上，向量化交给更专业的服务更划算。 桥提供外挂转发：客户端仍然只配一个 base_url，chat 走算力集市、 embedding 走你指定的服务。

export A7W_EMBEDDING_BASE_URL=http://127.0.0.1:11434/v1   # Ollama
export A7W_EMBEDDING_MODEL=bge-m3
export A7W_EMBEDDING_API_KEY=sk-xxx                        # 可选

不配也能用——/v1/embeddings 会返回 501 并附上配置指引。

七、脚本清单

PYTHONDONTWRITEBYTECODE=1 python -X utf8 scripts/selftest.py -v

八、依赖条件

• Python 3.8+，仅标准库（urllib / json / base64），不需要 pip install
• 一个算力集市账号 + API Key（注册领取，用户中心 → API 密钥）
• 能访问 https://api.a7w.cn 的网络出口

九、关于作者

本 Skill 由作者亲自实操验证后发布。 下载后可自用、可商用。 使用中遇到任何问题，欢迎加技术微信 9872659 交流—— 报一下是从哪个 Skill 找来的，直接给你配套的 API Key 和能跑通的示例。

相关链接

配套技能