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

16 KiB
Raw Blame History

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 模型广场。下表为登录后两页目录中的准确标识。

上游模型标识 当前 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 模型广场。使用单独渠道和相应站点 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

控制台、模型定价、当前 API 文档、聊天接口文档。

控制台最新公告为 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 文档、API Key、定价。

  • 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 用量结算,失败释放预留。部署前需填写价格并给测试账号发放余额,否则真实模型会被拒绝调用。报价、计费精度、断流及幂等规则见 流式聊天与人民币计费。平台用户账本和上游钱包独立,上游消费不等于平台收入。

价格单位必须和调用方式匹配:同步/流式聊天使用 CNY / 1M tokens 并填写输入、输出价格;异步媒体任务使用非 Token 单位时填写 price 和单位(例如 CNY / task),平台在创建任务时预留该固定金额,任务成功扣除、失败释放。已配置价格但没有对应计费实现的模型会保持不可调用状态。

一个渠道配置多个上游 Key

可以。当前 OpenAI 兼容转发器支持为同一渠道配置多个上游 Key,并按请求轮换,适合把上游的单 Key 并发拆到多个 Key。服务器环境变量优先使用渠道编码(管理端渠道的 code),也兼容渠道 ID 转成大写下划线后的名字,Key 之间用 | 分隔。例如渠道编码为 apipro 时:

MOYI_UPSTREAM_API_KEYS_APIPRO='key_a|key_b|key_c'

保留管理端渠道中的单个凭据作为回退 Key。同步聊天和已接入的异步执行器都会在每个请求或轮询请求前轮换 Key。轮换只解决 Key 分摊,不能突破上游账户总并发、余额、模型授权或速率限制;平台自己的模型并发和单个 MOYI Key 并发仍由网关队列控制。多个 Key 应来自同一渠道、具有相同模型授权,并在服务器密钥文件中保存,不能提交到 Git。当前没有把这些 Key 明文放进管理端数据库的功能,避免把上游密钥暴露给前端;需要新增或撤销 Key 时修改服务器 .env.cloud 后重启 API 容器即可。