ModelHub Open API

返回标准 OpenAI 模型列表。ModelHub 的上下文、模态、能力、端点和渠道信息放在 modelhub 扩展对象中。

curl https://modelhub.xctoy.cn/v1/models \
  -H "Authorization: Bearer sk-xc-你的令牌"复制

常用扩展字段：context_window、max_output_tokens、input_modalities、output_modalities、supported_parameters、endpoint_count、providers 与 route_modes。

查询当前令牌的用量、金额额度与活跃预算预占。

curl https://modelhub.xctoy.cn/v1/usage \
  -H "Authorization: Bearer sk-xc-你的令牌"复制

{
  "key": "项目令牌",
  "used_m": 1.2,
  "quota_m": 5,
  "quota_amount": 500,
  "used_amount": 12.34,
  "reserved_amount": 0.56,
  "remaining_amount": 487.1
}复制

reserved_amount 是进行中请求的临时预占，不等于已扣费；remaining_amount 已扣除已用金额和活跃预占。quota_amount=0 时返回 null，表示金额额度不限。

OpenAI 兼容的对话补全接口，支持流式（stream: true）。请求与响应结构与 OpenAI 一致。

请求参数

curl https://modelhub.xctoy.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xc-你的令牌" \
  -d '{"model": "deepseek-flash", "messages": [{"role": "user", "content": "帮我总结三段话"}]}'复制

OpenAI Responses 兼容入口，支持文本、图片输入、工具调用、流式事件、请求级路由与跨模型 fallback。网关内部翻译到现有 Chat 渠道，计费和降级口径与 Chat Completions 一致。

请求参数

curl https://modelhub.xctoy.cn/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xc-你的令牌" \
  -d '{
    "model": "deepseek-flash",
    "input": "用三句话解释什么是模型网关"
  }'复制

Anthropic Messages 兼容接口，适用于 Claude Code、Claude Desktop、Cherry Studio 与 Anthropic SDK。网关在内部复用现有 Chat 渠道，路由、降级、熔断与计费口径不变。

鉴权头

curl https://modelhub.xctoy.cn/v1/messages \
  -H "x-api-key: sk-xc-你的令牌" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-2.5-pro-beta",
    "max_tokens": 2048,
    "system": "你是严谨的技术助手。",
    "messages": [{"role": "user", "content": "解释分布式锁的取舍"}]
  }'复制

支持文本、图片、工具调用、流式 SSE 与可选 models / provider 路由参数。错误体使用 Anthropic 标准：{"type":"error","error":{"type":"...","message":"..."}}。

基于 DeepSeek 自研搜索引擎的网页搜索接口，按关键词返回结构化网页结果，面向 Agent / RAG 场景设计。底层能力来自 DeepSeek Search API，见 DeepSeek 官方文档。

请求参数

响应（每条结果字段）

curl https://modelhub.xctoy.cn/v1/tools/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xc-你的令牌" \
  -d '{"query": "ModelHub 网关", "count": 5}'复制

抓取单个网页，返回 Markdown 格式的标题与正文，适合把搜索命中的页面内容喂给模型。

请求参数

curl https://modelhub.xctoy.cn/v1/tools/fetch \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xc-你的令牌" \
  -d '{"url": "https://api-docs.deepseek.com/zh-cn/"}'复制

OpenAI 兼容的向量化接口，可用于 RAG 检索、语义去重等场景。

可用模型

对检索候选做相关性重排，适合 RAG 精排阶段。

可用模型

固定结构化识图接口，返回场景、光线、人物主体、面部、身体、服装与次要人物信息。引擎由平台内部路由，响应中不暴露引擎名。

传图方式

curl https://modelhub.xctoy.cn/v1/image/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xc-你的令牌" \
  -d '{"image_url":"https://example.com/photo.jpg"}'复制

• JSON 方式单次最多 3 张，使用 images 数组或单张 image_url。
• 不接受自定义提问参数；需要按问题分析图片时改用支持视觉输入的 Chat 或 Responses 模型。
• 服务端会将图片压到长边 1536px 再识别；客户端提前压缩可减少传输耗时。
• 正常耗时约 20–70 秒，建议客户端超时 ≥320 秒。
• 频率限制 60 次/分钟，按次计费 0.05 元/次；缓存命中仍计费。

• agnes-image-2.5-flash：同步图片生成，支持文生图、图生图、多图合成；1K / 2K / 3K / 4K。上游官方当前试用价为零，网关调用按张计费。
• agnes-video-2.5：异步视频生成，支持文生视频、首尾帧和图片/音频/视频参考。

图片使用 POST /v1/images/generations；视频先用 POST /v1/videos 创建任务，再轮询 GET /v1/agnesapi?video_id=...&model_name=agnes-video-2.5。媒体 URL 必须公网可访问且任务完成前不过期。

视频任务创建后返回 video_id 与初始状态，轮询到 completed 后从返回的 url 获取视频；失败状态为 failed。