Files
ipass__ipass/www/apix.html
T
admin 4533db8536 feat(apix): 透传模式 passthrough —— 通用内部 REST 出口 (1.0.20)
- 模型加 mode 字段(vendor 默认 / passthrough 新增),shm payload 扩为 4 字段
  base\nkey\nasset_id\nmode;旧数据零迁移(无 mode → vendor)
- 拆 location 而非按 mode 分支:/apixp/ 不施加 vendor 强约束
  (proxy_method POST + 强制 Content-Type + proxy_pass_request_headers off
  是 location 级指令,无法按请求级 shm 的 mode 动态切换)
- handler 校验路径前缀 vs mode 一致(vendor slug 走 /apixp/ → 404,反之亦然),
  避免 vendor 条目继承 passthrough 强制 Content-Type 致 415 之类静默故障
- passthrough:方法/请求体/Content-Type 原样透传(含 multipart),上游路径
  = base + /apixp/<slug> 之后的 URI 尾部(含 query 由模块拼,变量式 proxy_pass
  不自动追加);Key 可空(内部服务免鉴权,下发时 nginx 空串 = 不发该头)
- 探测按 mode 分流:vendor 走 POST 预估 / passthrough 走 GET 打上游根地址
- nginx:lm server 加 /apixp/,mdm server 加 /_apixp_probe/(internal)
- 测试 §11.6 新增 35 条断言(鉴权/路径转发/体透传/Key 下发/路径-mode 一致
  /管理台回显/探测);账号态 count 1→3 同步;回归 225/0 全绿
- 管理台:列表加 mode 标签、表单加 mode 下拉 + 透传说明 + 路径示例复制
- 文档:docs/apix/PASSTHROUGH_MODE.md 真源(决策/兼容/改动一览)

OCR 是第一条 passthrough 配置:/apixp/ocr/ocr、/apixp/ocr/ocr/base64、
/apixp/ocr/ocr/url?src=...
2026-09-15 10:51:29 +08:00

48 lines
1.9 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<base href="/admin/">
<title>API 代理 · 尚数网 山海关</title>
<link rel="stylesheet" href="assets/admin.css">
</head>
<body>
<div id="shell"></div>
<div class="wrap">
<div class="panel">
<div class="panel-head">
<div>
<h2>代理列表</h2>
<div class="desc">
把外部供应商的 API 挂到网关下:调用方用<b>同一把账号 API Key</b> 访问
<code>/apix/&lt;slug&gt;?参数=值</code>,网关换成<b>该代理自身登记的供应商 Key</b>后转发,并返回供应商原样结果。
每家供应商的基址与 Key 都在每一条代理里单独填写,互不影响。停用的代理对调用方表现为 404(共享内存已摘除,立即生效)。
<br><br>
<b>代理模式</b>:
<span class="badge" style="background:#eee;color:#666">vendor</span>
单一供应商收口 <code>POST /api/v1/ai/request</code>,网关按 <code>asset_id</code> 拼体(防止客户端挑最贵的资产刷);
<span class="badge" style="background:#eef6ee;color:#3a7">passthrough</span>
透传内部 REST 服务(OCR / 文生图 / TTS),访问 <code>/apixp/&lt;slug&gt;/&lt;路径尾部&gt;</code>,
方法/请求体/Content-Type 原样转发,上游路径 = base + 尾部。
</div>
</div>
<button class="btn-primary btn-sm" id="newApixBtn">+ 新建代理</button>
</div>
<table>
<thead><tr>
<th>slug</th><th>asset_id</th><th>调用地址</th><th>供应商</th><th>状态</th><th>创建时间</th><th>操作</th>
</tr></thead>
<tbody id="apixBody"></tbody>
</table>
</div>
</div>
<div id="toast"></div>
<script src="assets/core.js"></script>
<script src="assets/apix.js"></script>
</body>
</html>