# ApiHub、TokenFoundryX、APIPro 与 Tripo 接入清单 核对日期:2026-09-27。MOYI 代码基线:V24 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 `。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,即默认 `¥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 容器即可。