aihub-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AIHUBMAX_API_KEY | Yes | Your AihubMax API key (sk-...). Required. | |
| AIHUBMAX_BASE_URL | No | Optional base URL to override the default AihubMax API endpoint. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_modelsA | 列出 AihubMax 的媒体生成模型(图像/视频/音频/文档)。可按 media_type 或关键词过滤。available=true 表示当前 API Key 分组可直接调用;available=false 表示文档中存在但当前 Key 未开通。price 为定价摘要,group_ratios 给出各分组倍率(最终价=基准×倍率)。 |
| describe_modelA | 返回指定模型的提交端点、必填/可选参数(含类型、枚举、默认值、中文说明)与一个示例请求。生成前用它确认参数,避免 422。 |
| generate_imageA | 提交图像生成/编辑任务。 先用 describe_model 确认该 model 的参数。默认等待 60s:短任务直接返回结果 URL;长任务超时返回 task_id,用 get_task 继续查询。 |
| generate_videoA | 提交视频生成任务(通常耗时较长)。 先用 describe_model 确认该 model 的参数。默认等待 60s:短任务直接返回结果 URL;长任务超时返回 task_id,用 get_task 继续查询。 |
| generate_audioA | 提交音频任务:TTS/音乐/语音识别/语音克隆(Suno 自动走专用端点)。 先用 describe_model 确认该 model 的参数。默认等待 60s:短任务直接返回结果 URL;长任务超时返回 task_id,用 get_task 继续查询。 |
| generate_documentA | 提交文档处理任务(如 Doc2X:PDF→md/tex/docx)。 先用 describe_model 确认该 model 的参数。默认等待 60s:短任务直接返回结果 URL;长任务超时返回 task_id,用 get_task 继续查询。 |
| get_taskA | 查询异步任务。wait_seconds>0 时在服务端轮询(每 5s)直到完成或超时。完成后 results 内为结果(图/视频/音频为 {url},24 小时内有效,请尽快转存)。 |
| wait_for_taskA | 阻塞等待某个异步任务直到完成/失败或达到单次等待上限。等待期间向支持的客户端发送 MCP 进度通知。达到 timeout_seconds 仍未完成则返回 still-running(含最新状态),可再次调用续等。适合长任务(视频等)。 |
| download_assetA | 把任务产物或任意 URL 下载到本地磁盘(视频等大文件的显式落盘手段)。传 task_id 时下载其成功结果里的全部 url;或直接传 url。产物 URL 24 小时失效,请及时下载。 |
| get_creditsA | 查询当前 API Key 的总额度、已用量与剩余额度。数据来自 New API 的计费端点。数值单位为站点展示单位(可能是美元/人民币/tokens,由站点配置决定),字段名沿用 OpenAI 惯例的 _usd 但不代表一定是美元。unlimited=true 表示该 Key 为无限额度。 |
| upload_fileA | 把本地文件或远程 URL 转存为 AihubMax 可直接引用的 URL(用于 image-to-video 等需要 image_urls/audio_url 的场景)。三选一:path(本地文件)、url(远程转存)、base64。返回的 url 可填入生成参数。 |
| analyze_mediaA | 用多模态 LLM 分析媒体内容并输出文本(宿主模型自身无法看视频/听音频,此为能力补充)。三选一提供 image_urls / video_urls / audio_url(协议自动判别)。异步提交:默认等待 60s,短任务直接返回 text;长任务(视频/思考模型)超时返回 task_id,用 get_task / wait_for_task 取回。模型来自 llm-router 注册表(与生成类不同),用支持对应能力的模型(如 gemini-3.1-pro-preview 支持 vision/video/audio);model 无效时错误会列出可用模型。 |
| ask_modelA | 调用一个 LLM 做对话,定位为“向另一个模型征询二次意见 / 试用”,不是主对话通道、不支持流式。异步提交 + 轮询:默认等待 60s,短问答直接返回 text;超时返回 task_id 用 get_task / wait_for_task 取回。model 用 llm-router 注册表模型(如 gemini-3.5-flash、claude-sonnet-4-6、gpt-5.5;可用集见 /v1/configs/llm_generations_models,与生成类不同)。传 prompt(单轮)或 messages(多轮,OpenAI 格式)。 |
| create_embeddingsB | 生成文本向量嵌入(OpenAI 兼容)。model 用嵌入模型 id(如 text-embedding-3-small、jina-embeddings-v3)。input 为字符串或字符串数组。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cookaihq/aihub-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server