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

183 lines
14 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-21。MOYI 代码基线:待发布版本(含 V14 目录迁移)。
本文记录供应商页面实际展示的模型 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 已登录;公开模型广场显示 306 个模型,控制台确认聊天地址为 `https://api.apipro.ai/v1/chat/completions`,当前导航文档地址为 `https://apipro.apifox.cn/`。
- V14 迁移会幂等登记 APIPro 306 项、ApiHub 25 项和 TokenFoundryX 13 项模型,并为每项创建对应来源分组。新增分组默认停用且未定价;图像、音频、视频、向量和未确认的内部条目不会被误开放。
- 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` | `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 测试,再添加其他文本模型。输入图片、工具调用等能力需要单独验收,不能仅凭模型广场的标签声明已支持。
## 国外站目录: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`,不要直接照抄该错误示例。
广场显示 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 官方
国际站官方文档:[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)。平台用户账本和上游钱包独立,上游消费不等于平台收入。