feat: stream chat and settle metered CNY usage atomically

This commit is contained in:
wlx committed 2026-09-20 01:36:22 +08:00
1 parent 7360cf3ebe
commit b46ee72f2d
28 files changed
+1098 -86

No files matched your search

+181
View File
@@ -0,0 +1,181 @@
# ApiHub、TokenFoundryX、APIPro 与 Tripo 接入清单
核对日期:2026-09-20。MOYI 代码基线:7360cf3e。
本文记录供应商页面实际展示的模型 ID,不代表对其底层模型身份、宣传能力或官方版本名称的独立认证。目录可见不等于当前 Key 有权限,也不等于已经在 MOYI 实测。
## 已完成和待完成
- 已登录核对 ApiHub 国内站的 25 个模型,以及 TokenFoundryX 国外站的 13 个模型。
- ApiHub 国内站游乐场和 MOYI 网关均已验证 `deepseek-v4-flash`。2026-09-20 00:58:48(北京时间)MOYI 返回 `OK`,记录输入 101、输出 8 Token,耗时 1.89 秒。
- 两站控制台分别给出自己的 `/v1/chat/completions` 示例;国内钱包按 CNY 展示,国外钱包按 USD 展示。国外站控制台当时提示需要创建 API Key;不能假定国内 Key 可直接复用。
- APIPro 已登录;公开模型广场显示 305 个模型,控制台确认聊天地址为 `https://api.apipro.ai/v1/chat/completions`,当前导航文档地址为 `https://apipro.apifox.cn/`。
- MOYI 已有用户创建的 `apihub` 渠道(名称“内测1”)和保存的凭据。本次已将协议从 HTTP 修正为 OpenAI 兼容,将 Base URL 补全为 `https://apihub.chem-cloud.cn/v1`,未读取或替换原凭据。
- 已在现有 DeepSeek V4 Flash 下添加“ApiHub 国内”分组,关联“内测1”,路由 ID `3dc5d0f8-c7b5-4ff3-9ae8-9077e2e957a9`。
- APIPro 渠道已保存,添加“APIPro · DeepSeek”分组,路由 ID `6680d434-538f-408a-bf9a-668801763b79`。2026-09-20 01:20:14 MOYI 返回 `OK`,输入 22、输出 31 Token,耗时 2.12 秒。
- 两次均为旧版服务器上的同步调用,平台费用显示未记录;只验证渠道和模型路由,不代表新版流式/计费已部署验收。两个 MOYI 临时联调 Key 均已停用,调用记录保留。
## 渠道管理填写
在 MOYI 管理端打开“渠道管理”。国内站已存在 `apihub` / “内测1”,编辑该渠道即可;其他渠道可按下表添加。以下名称可自行修改。
| 字段 | ApiHub 国内 | TokenFoundryX 国外 | APIPro |
|---|---|---|---|
| 渠道 Code | 现有 `apihub` | `tokenfoundryx-global` | `apipro` |
| 渠道名称 | 现有“内测1” | TokenFoundryX 国外 | APIPro |
| 来源类型 | 中转站 | 中转站 | 中转站 |
| 接入协议 | OpenAI 兼容 | OpenAI 兼容(用于其聊天端点) | OpenAI 兼容 |
| Base URL | `https://apihub.chem-cloud.cn/v1` | `https://www.tokenfoundryx.com/v1` | `https://api.apipro.ai/v1` |
| 凭据类型 | API Key | API Key | API Key |
| 凭据 | 国内站创建的 API Key 原文 | 国外站创建的 API Key 原文 | 该站对应 Key |
不要在凭据框添加 `Bearer ` 前缀,当前 MOYI 后端自动添加该前缀。Base URL 只填到 `/v1`,后端追加 `/chat/completions`,不要填完整聊天请求路径。
MOYI 用户对外使用的统一 API Base URL 为 `https://moyi.soulofmodel.com/v1`。这是本平台入口,与渠道表中的上游地址不同。
## 第一条模型与分组
先接入已在上游游乐场验证的 `deepseek-v4-flash`。
在“模型与分组”搜索已有模型;如果已有相同定义,编辑并添加分组即可,避免重复创建。
| 添加/编辑模型字段 | 填写值 |
|---|---|
| 模型名称 | DeepSeek V4 Flash |
| 统一模型标识 | `deepseek-v4-flash` |
| 模型类型 | 文本 |
| 调用模式 | 同步 |
| 输入类型 | `text` |
| 输出类型 | `text` |
| 模型说明 | ApiHub 国内转发,首轮验证文本聊天 |
在该模型下点击“添加分组”:
| 字段 | 填写值 |
|---|---|
| 分组名称 | ApiHub 国内 |
| 渠道 | 内测1(Code 为 `apihub`) |
| 上游模型标识 | `deepseek-v4-flash` |
| 输入价格、输出价格 | 待确定平台人民币售价后填写;新版计费会阻止未定价真实模型调用 |
| 价格单位 | `CNY / 1M tokens` |
| 优先级 | `100` |
| 并发上限 | `1` |
上游模型广场的价格可能包括折扣、缓存、动态阶梯。它是上游成本参考,不应未经确认直接作为本平台售价。美元金额也不能原样写入人民币报价。
“ApiHub 国内”等 MOYI 分组名由本平台自定义;上游的 `default`、`5.8折` 属于上游账号/Key 的路由和定价规则,两者不会自动同步。需要在上游 Key 页面确认该 Key 可访问目标模型及所需上游分组。
## 国内站目录:25 个
来源:[ApiHub 模型广场](https://apihub.chem-cloud.cn/pricing)。下表为登录后两页目录中的准确标识。
| 上游模型标识 | 当前 MOYI 首轮处理 |
|---|---|
| `deepseek-v4-flash` | 文本、同步;首个联调模型 |
| `deepseek-v4-pro` | 文本、同步;逐个测试 |
| `glm-4.7` | 文本聊天、同步;逐个测试 |
| `glm-5` | 文本聊天、同步;逐个测试 |
| `glm-5.1` | 文本聊天、同步;逐个测试 |
| `glm-5.2` | 文本聊天、同步;逐个测试 |
| `kimi-k2.5` | 首轮仅测试文本聊天、同步 |
| `kimi-k2.6` | 首轮仅测试文本聊天、同步 |
| `kimi-k2.7-code` | 代码、同步;逐个测试 |
| `kimi-k3` | 文本聊天、同步;逐个测试 |
| `qwen3-coder-plus` | 代码、同步;逐个测试 |
| `qwen3-max` | 文本聊天、同步;逐个测试 |
| `qwen3.5-plus` | 首轮仅测试文本聊天、同步 |
| `qwen3.6-plus` | 首轮仅测试文本聊天、同步 |
| `qwen3.7-max` | 文本聊天、同步;逐个测试 |
| `qwen3.7-plus` | 文本聊天、同步;逐个测试 |
| `qwen3.8-max` | 文本聊天、同步;逐个测试 |
| `doubao-seedream-5-0-260128` | 图像生成;当前网关未实现对应接口,暂不启用 |
| `doubao-seedream-5-0-pro-260628` | 图像生成;当前网关未实现对应接口,暂不启用 |
| `doubao-seedance-1-0-pro-250528` | 视频任务;需补齐上游异步适配,暂不启用 |
| `doubao-seedance-1-0-pro-fast-251015` | 视频任务;需补齐上游异步适配,暂不启用 |
| `doubao-seedance-1-5-pro-251215` | 视频任务;需补齐上游异步适配,暂不启用 |
| `doubao-seedance-2-0-260128` | 视频任务;需补齐上游异步适配,暂不启用 |
| `doubao-seedance-2-0-fast-260128` | 视频任务;需补齐上游异步适配,暂不启用 |
| `doubao-seedance-2-0-mini-260615` | 视频任务;需补齐上游异步适配,暂不启用 |
先完成一个文本模型的 MOYI 测试,再添加其他文本模型。输入图片、工具调用等能力需要单独验收,不能仅凭模型广场的标签声明已支持。
## 国外站目录:13 个
来源:[TokenFoundryX 模型广场](https://www.tokenfoundryx.com/pricing)。使用单独渠道和相应站点 API Key;MOYI 分组名称建议 `TokenFoundryX 国外`。
| 上游模型标识 | 当前 MOYI 首轮处理 |
|---|---|
| `claude-fable-5` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-fable-5-1` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-opus-4-6` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-opus-4-7` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-opus-4-8` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-opus-5` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-sonnet-4-5` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-sonnet-4-6` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `claude-sonnet-5` | 站内标记 OpenAI/Anthropic;先确认聊天兼容性再启用 |
| `gpt-5.6-sol` | 控制台给出聊天请求示例,待真实 Key 测试 |
| `gpt-5.6-terra` | 站内标记 OpenAI;待聊天兼容性测试 |
| `gpt-6-astra` | 站内标记 OpenAI;待聊天兼容性测试 |
| `gpt-image-2` | 图像生成;当前网关未实现对应接口,暂不启用 |
该目录仅按中转站展示原样记录,不将别名等同于厂商官方模型身份。
## APIPro
[控制台](https://api.apipro.ai/dashboard/overview)、[模型定价](https://api.apipro.ai/pricing)、[当前 API 文档](https://apipro.apifox.cn/)、[聊天接口文档](https://apipro.apifox.cn/402023923e0)。
控制台最新公告为 2026-09-17“国内站点下架,统一使用海外站点”。本次登录确认的聊天示例是 `POST https://api.apipro.ai/v1/chat/completions`,认证为 `Authorization: Bearer <API_KEY>`。MOYI Base URL 填 `https://api.apipro.ai/v1`。控制台加载慢不等同于模型请求耗时;实际调用需要分别验证。
模型详情自动生成的 OpenAI 示例曾把 DeepSeek 文本请求地址写成 `/v1/videos`,与控制台聊天示例和专门的聊天文档不一致。文本聊天应使用 `/v1/chat/completions`,不要直接照抄该错误示例。
广场显示 305 个模型;以下 13 个为本次按 `deepseek` 搜索实际核对的完整子集,不代表 305 个全部已逐一验收:
| 上游模型标识 | 首轮用途 |
|---|---|
| `deepseek-ocr` | OCR;不纳入首轮纯文本测试 |
| `deepseek-r1` | 备用文本模型,待测 |
| `deepseek-r1-distill-qwen-32b` | 备用文本模型,待测 |
| `deepseek-v3` | 备用文本模型,待测 |
| `deepseek-v3-0324` | 备用文本模型,待测 |
| `deepseek-v3.1` | 备用文本模型,待测 |
| `deepseek-v3.2` | 备用文本模型,待测 |
| `deepseek-v3.2-think` | 推理模型,待测 |
| `deepseek-v4-flash` | 首个联调模型,复用 MOYI 已有模型定义 |
| `deepseek-v4-flash-0731` | 站内版本标识,待测 |
| `deepseek-v4-pro` | 第二个候选,复用 MOYI 已有模型定义 |
| `deepseek-v4-pro-0813` | 站内版本标识,待测 |
| `deepseek-v4.1-flash` | 站内版本标识,待测 |
`deepseek-v4-flash` 详情页列出 `bailian`、`deepseek`、`deepseek-claude`、`llm-cn` 的价格行;创建 Key 时账号实际可选 `deepseek`。首轮选此分组,限制模型为 `deepseek-v4-flash`。MOYI 下建议添加分组“APIPro · DeepSeek”,关联 `apipro` 渠道,上游模型保持 `deepseek-v4-flash`。
该模型页面当前展示输入 0.143 USD / 1M、输出 0.286 USD / 1M、缓存输入 0.029 USD / 1M。这是上游页面报价,真实消费以日志为准,不能直接当成人民币售价。MOYI 的自定义分组名不会自动改变 APIPro Key 所选的分组;若以后要区分 APIPro 内部的多个来源,应分别创建上游 Key 和 MOYI 渠道,再将各模型分组关联到对应渠道。
已创建并保存的 `MOYI联调` 上游 Key 仅允许 `deepseek` 分组和 `deepseek-v4-flash`,1 天有效、额度上限 1 USD,页面显示到期时间 2026-09-21 00:11。它是短期测试凭据,持续使用前必须在 APIPro 创建适当范围的正式 Key,再编辑 MOYI 的 APIPro 渠道替换凭据。
## Tripo 官方
国际站官方文档:[General](https://platform.tripo3d.ai/docs/general)、[Authentication](https://platform.tripo3d.ai/docs/quick-start)、[Generation](https://platform.tripo3d.ai/docs/generation)。
- 国际站 API Base URL:`https://api.tripo3d.ai/v2/openapi`。
- 使用 HTTP Bearer API Key;创建任务为 `POST /task`,查询为 `GET /task/{task_id}`。
- 文生 3D 请求使用 `type=text_to_model`,版本放在 `model_version`,不能按 OpenAI 聊天请求直接转发。
- 当前官方生成文档列出的版本包括 `P1-20260311`、`Turbo-v1.0-20250506`、`v3.1-20260211`、`v3.0-20250812`、`v2.5-20250123` 等,实际选型需结合账号权限及价格。
- 若 Key 来自国内 `platform.tripo3d.com`,使用其对应文档与端点;不能假定 `.ai` 和 `.com` 凭据互通。
- 建议渠道 Code `tripo-official`、名称 `Tripo 官方`、来源“官方供应商”、协议 HTTP、凭据类型 Bearer Token。先不要把真实 3D 模型作为已可用发布。
- 7360cf3e 的 Java `AsyncTaskService` 对非 Mock 异步供应商返回 `ASYNC_PROVIDER_NOT_IMPLEMENTED`。必须补齐创建、轮询、状态持久化、错误处理、结果链接与使用记录后,才能在 MOYI 使用官方 Key 测试。
## MOYI 联调顺序
1. 在管理员渠道表单填写国内站 Key;只输入在自己的管理端,不贴入聊天、文档或 Git。
2. 建立上述 DeepSeek 模型及 `ApiHub 国内` 分组,确认渠道、模型和分组均启用。
3. 切到用户端“API Keys”,创建一个联调 Key,先选择模型,再勾选该分组。
4. 在“在线调试”选择该模型和分组,使用 MOYI 平台生成的 Key,发送短提示词“请只回复 OK”。这里不使用上游 Key。
5. 确认返回非 Mock 的实际文本;在“使用记录”检查模型、分组、状态、耗时及 Token,在上游日志核对对应请求。
6. 再逐个添加其他文本模型和 APIPro 分组。每个新分组需明确授权给联调 Key;已有 Key 不会自动获得新分组权限。
程序调用时先请求 `GET https://moyi.soulofmodel.com/v1/models`,使用返回的 `data[].id` 作为聊天请求 `model`。当前实现使用分组/路由 ID,表单中的“统一模型标识”是展示字段,不是可直接调用的别名。旧版使用 `stream:false`;部署包含 V13 的新版后可使用 `stream:true`。
新版提供 OpenAI 兼容聊天的同步/流式转发、文本消息、工具参数透传和输出上限。Responses 原生接口、Anthropic 原生接口、多模态输入、真实图像/视频/3D 执行器仍需单独适配。中转站各模型的具体参数支持需要逐个验证。
新版按分组人民币售价预留余额,以实际 Token 用量结算,失败释放预留。部署前需填写价格并给测试账号发放余额,否则真实模型会被拒绝调用。报价、计费精度、断流及幂等规则见 [流式聊天与人民币计费](16-streaming-chat-billing.md)。平台用户账本和上游钱包独立,上游消费不等于平台收入。