Files
moyi-model-intelligence-hub/docs/15-relay-onboarding.md
T

202 lines
17 KiB
Markdown
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.
# ApiHub、TokenFoundryX、APIPro 与 Tripo 接入清单
核对日期:2026-09-27。MOYI 代码基线:V25 Tripo 标准任务价、目录与真实异步队列修复。
本文记录供应商页面实际展示的模型 ID,不代表对其底层模型身份、宣传能力或官方版本名称的独立认证。目录可见不等于当前 Key 有权限,也不等于已经在 MOYI 实测。
## 已完成和待完成
- 已登录核对 ApiHub 国内站的 25 个模型,以及 TokenFoundryX 国外站当前页面的 20 个模型。
- 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 已登录;公开模型广场显示 306 个模型,控制台确认聊天地址为 `https://api.apipro.ai/v1/chat/completions`,当前导航文档地址为 `https://apipro.apifox.cn/`。
- V14 迁移会幂等登记 APIPro 306 项、ApiHub 25 项和 TokenFoundryX 首批 13 项模型;V22 补充 TokenFoundryX 页面新增的 7 项,合计 20 项并为每项创建对应来源分组。新增分组默认停用;没有明确价格或没有对应执行器的模型不会被宣称为可调用。
- MOYI 已有用户创建的 `apihub` 渠道(名称“内测1”)和保存的凭据。本次已将协议从 HTTP 修正为 OpenAI 兼容,将 Base URL 补全为 `https://apihub.chem-cloud.cn/v1`,未读取或替换原凭据。
- 已在现有 DeepSeek V4 Flash 下添加“ApiHub 国内”分组,关联“内测1”。调用时请以当前环境 `GET /v1/models` 返回的 `data[].id` 为准;路由 ID 在迁移或重新建组后可能变化,不要复制旧环境中的固定 UUID。
- APIPro 渠道已保存,添加“APIPro · DeepSeek”分组。调用时请以当前 API Key 请求 `GET /v1/models` 返回的 `data[].id` 为准;数据库迁移或重新建组会生成新的路由 UUID。2026-09-20 01:20:14 的旧环境联调曾返回 `OK`,不代表该历史 ID 在当前部署仍有效。
- 两次均为旧版服务器上的同步调用,平台费用显示未记录;只验证渠道和模型路由,不代表新版流式/计费已部署验收。两个 MOYI 临时联调 Key 均已停用,调用记录保留。
## 渠道管理填写
在 MOYI 管理端打开“渠道管理”。国内站已存在 `apihub` / “内测1”,编辑该渠道即可;其他渠道可按下表添加。以下名称可自行修改。
| 字段 | ApiHub 国内 | TokenFoundryX 国外 | APIPro |
|---|---|---|---|
| 渠道 Code | 现有 `apihub` | `tokenfoundryx` | `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` |
| 并发上限 | 以 MOYI 管理端该分组的“并发上限”为准;旧目录导入默认是 `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 测试,再添加其他文本模型。输入图片、工具调用等能力需要单独验收,不能仅凭模型广场的标签声明已支持。
## 国外站目录:20 个
来源:[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` | 图像生成;当前网关未实现对应接口,暂不启用 |
| `gemini-2.5-flash-lite` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gemini-2.5-pro` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gemini-3.7-flash` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gemini-3.8-flash` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gpt-5.4` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gpt-5.4-mini` | 文本聊天;需核对价格和 Key 权限后启用 |
| `gpt-5.5` | 文本聊天;需核对价格和 Key 权限后启用 |
该目录仅按中转站展示原样记录,不将别名等同于厂商官方模型身份。
## 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`,不要直接照抄该错误示例。
广场显示 306 个模型;V14 迁移按广场完整目录登记 306 项。以下 13 个为本次按 `deepseek` 搜索实际核对的子集:
| 上游模型标识 | 首轮用途 |
|---|---|
| `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 官方
官方文档:[Tripo API 文档](https://developers.tripo3d.com/zh/docs)、[API Key](https://developers.tripo3d.com/zh/keys)、[定价](https://developers.tripo3d.com/zh/pricing)。
- Java 执行器使用 Tripo V3 API Base URL:`https://openapi.tripo3d.com/v3`,提交 `POST /generation/text-to-model`,轮询 `GET /tasks/{task_id}`。
- 当前发布 H 系列 `v3.1-20260211`、`v3.0-20250812`、`v2.5-20250123` 三个异步文生 3D 模型;执行器会保留 Tripo 返回的任务状态和结果链接。
- 现有适配器发送标准贴图参数(`texture=true`、`pbr=true`),官方标准价为每任务 20 credits,即 `$0.20 / task`(1 credit = $0.01);平台默认售价 `¥1.44 / task`(按 1 USD = 7.2 CNY;管理员可以在模型与分组中调整售价)。标准价与平台售价分别显示,不把汇率换算当成折扣。
- 若 Key 来自国内 `platform.tripo3d.com`,使用其对应文档与端点;不能假定 `.ai` 和 `.com` 凭据互通。
- 管理端已有 `vast-tripo` / `Tripo 官方` 渠道。可以在渠道管理中保存加密后的 Bearer Token,也可以在服务器 `.env.cloud` 中设置 `TRIPO_API_KEY`;环境变量只作为未配置数据库凭据时的安全回退,并支持后续轮换多个 Key(使用 `|` 分隔的上游 Key 列表时按轮询选择)。
- 配置真实 Key 后,先用一个低成本模型创建任务并轮询到终态,再把该分组发布给用户。不要把 Key 写入代码、SQL 迁移、Git 或聊天记录。
- Java 异步执行器已接入 Tripo(`provider-vast`)和 Seedance(`provider-bytedance`)的创建、轮询、状态持久化、失败处理和结果链接;未匹配这两个适配器的异步渠道仍会明确显示为“执行器待接入”,不会伪装成可用。
## 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 兼容聊天的同步/流式转发、文本消息、工具参数透传和输出上限;Tripo 3D 与 Seedance 视频已有对应的异步创建、轮询和结果持久化。Responses 原生接口、Anthropic 原生接口、多模态聊天输入仍需单独适配;未匹配执行器的异步渠道会显示为“执行器待接入”,不会创建假任务。中转站各模型的具体参数支持需要逐个验证。
新版按分组人民币售价预留余额,以实际 Token 用量结算,失败释放预留。部署前需填写价格并给测试账号发放余额,否则真实模型会被拒绝调用。报价、计费精度、断流及幂等规则见 [流式聊天与人民币计费](16-streaming-chat-billing.md)。平台用户账本和上游钱包独立,上游消费不等于平台收入。
价格单位必须和调用方式匹配:同步/流式聊天使用 `CNY / 1M tokens` 并填写输入、输出价格;异步媒体任务使用非 Token 单位时填写 `price` 和单位(例如 `CNY / task`),平台在创建任务时预留该固定金额,任务成功扣除、失败释放。已配置价格但没有对应计费实现的模型会保持不可调用状态。
## 一个渠道配置多个上游 Key
可以。当前 OpenAI 兼容转发器支持为同一渠道配置多个上游 Key,并按请求轮换,适合把上游的单 Key 并发拆到多个 Key。服务器环境变量优先使用渠道编码(管理端渠道的 code),也兼容渠道 ID 转成大写下划线后的名字,Key 之间用 `|` 分隔。例如渠道编码为 `apipro` 时:
```ini
MOYI_UPSTREAM_API_KEYS_APIPRO='key_a|key_b|key_c'
```
保留管理端渠道中的单个凭据作为回退 Key。同步聊天和已接入的异步执行器都会在每个请求或轮询请求前轮换 Key。轮换只解决 Key 分摊,不能突破上游账户总并发、余额、模型授权或速率限制;平台自己的模型并发和单个 MOYI Key 并发仍由网关队列控制。多个 Key 应来自同一渠道、具有相同模型授权,并在服务器密钥文件中保存,不能提交到 Git。当前没有把这些 Key 明文放进管理端数据库的功能,避免把上游密钥暴露给前端;需要新增或撤销 Key 时修改服务器 `.env.cloud` 后重启 API 容器即可。