文档 · 接入指南
托管 MCP 服务器:在任意 MCP 客户端里用模型、图片和视频
三个 MCP 服务器把目录里的模型接进 Claude Code、Cursor、VS Code 等客户端,用的是你的 API 密钥。接入方法、工具和每次调用的费用。
TopxAI 运行着三个 Model Context Protocol(MCP)服务器。MCP 客户端连上它们,就能用同一把 API 密钥、按和 API 一样的价格调用目录里的任意模型、生成图片和视频。MCP 页面会为每个客户端生成填好密钥的接入配置。
三个服务器
| 服务器 | 地址 | 工具 | 每次调用到模型时的费用 |
|---|---|---|---|
| TopxAI Models | https://api.topxai.xyz/mcp/models |
list_models、ask_model、judge |
0.001 美元 |
| TopxAI Images | https://api.topxai.xyz/mcp/images |
generate_image |
0.01 美元 |
| TopxAI Videos | https://api.topxai.xyz/mcp/videos |
generate_video、video_status |
0.01 美元 |
ask_model 向你指定的模型发一次对话请求;judge 向 Jev 发一个文字问题(图片素材和 Box 问题仍走 HTTP 接口)。generate_image 和 generate_video 对应图片和视频接口。list_models 和 video_status 不收费。
一次调用多少钱
调用到模型的工具调用,计费和同样的 API 请求完全一样:按密钥所在路线的模型价格,同样的预留和退款规则,用量日志里记一行。服务器的调用费作为单独一项加在这次请求上,请求失败时随请求一起退回。列出工具、查询视频进度都不收钱。
接入
用 API 密钥作为 Bearer 令牌鉴权,没有会话。Claude Code:
claude mcp add --transport http topxai-models https://api.topxai.xyz/mcp/models \
--header "Authorization: Bearer $TOPXAI_API_KEY"
Cursor(~/.cursor/mcp.json)以及其他用 JSON 配置的客户端:
{
"mcpServers": {
"topxai-models": {
"url": "https://api.topxai.xyz/mcp/models",
"headers": { "Authorization": "Bearer sk-..." }
}
}
}
VS Code 用同样的条目,写在 servers 下面,并加上 "type": "http"。图片和视频服务器照同样的方式各起一个名字加进去。
限制
- 服务器使用 Streamable HTTP,每次调用一个请求:只接受
POST,没有事件流,也没有会话。价格或模型变了,客户端下次列出工具时才看到;扣费始终按调用那一刻的价格。 - 暂时还没有 OAuth 登录,所以要求 OAuth 的连接器(Claude.ai、ChatGPT)连不上。能带请求头的开发者客户端可以连:Claude Code、Cursor、VS Code、Cline 和 curl。
- 没带密钥或者密钥错误,客户端也能连上并列出工具。这时调用工具会返回密钥哪里有问题,不会把请求发给模型,也不扣费。
ask_model能选的模型跟着密钥走:限定在某条路线的密钥,只列出那条路线上的模型。- 6 MiB 以内的图片直接放在结果里返回。更大的图片以签名链接返回,最长一小时有效;打开链接不会再生成一次,也不改变扣费。
相关
上一页:llm 命令行接 TopxAI:extra-openai-models.yaml · 下一页:线路与自动路由
其他语言:English