技能介绍

模型调用的现实痛点

在多模型协作的 Agent 工作流里，接入不同厂商的模型往往意味着反复处理密钥、端点、计费方式和错误重试。模型 ID 容易写错，价格信息散落在各个后台，离线快照又可能与线上真实配置不一致。ModelHub 面向这类场景，把“选模型、拿密钥、查价格、生成代码”收敛到一个受控流程里，让 Agent 可以直接通过统一网关调用文本、图像、视频和嵌入等多种模型。

核心能力与关键步骤

ModelHub 默认走中国区网关 https://api.vicoco.cn/api/gateway/v1，仅在用户明确要求国际站时切换到 https://api.vicrocode.com/api/gateway/v1。它不会凭空捏造模型 ID，而是优先通过 GET /api/gateway/v1/models 获取实时模型列表；需要精确价格时，再调用已鉴权的 GET /api/gateway/v1/models/pricing?model=MODEL_ID，如果该端点不可用，则只确认模型可用性，不推断价格。

密钥与授权：脚本 scripts/vicro_models.py 提供 guide、auth-start PHONE、auth-verify PHONE CODE、keys-create 等命令。敏感操作（创建/列出密钥、查询用量与日志、用用户密钥测试模型）需要先完成手机号验证码授权，授权令牌存入 VICROCODE_SKILL_AUTH_TOKEN，有效期 24 小时。
模型选择与价格：list 拉取模型 ID，search 对模糊名称做归一化搜索，price MODEL 返回实时计费选项。如果视频模型返回“按次”和“按秒”等混合计费，脚本会分别展示，并建议在集成前明确选择哪一类。
代码生成：根据用户目标自动匹配端点族，包括 OpenAI 兼容的 /chat/completions、图像生成 /images/generations、视频任务 /videos/generations、嵌入 /embeddings，以及 Anthropic 原生 /v1/messages 和 Gemini 原生 /gemini/models/{model}:generateContent。
安全边界：API Key 只通过环境变量 VICROCODE_API_KEY 使用，绝不要求用户把密钥贴进聊天。未经用户明确同意，不会发起任何实时测试调用，因为测试会消耗平台金币。

适用边界与注意点

ModelHub 是面向 VicroCode 网关的工具，不负责模型训练或微调。本地 api-gateway-packages 中的导入快照不能当作线上价格或供应商名称的权威来源，它们可能使用不同的 slug。若 /models/pricing 未部署，脚本会直接告知无法读取实时价格，而不是用离线数据补齐。注册用户即可通过该技能调用模型，超级个体 VIP 并非必需，但敏感操作仍依赖手机验证。测试和视频生成任务都可能消耗金币，务必在获得用户确认后再执行。