SuperAPI AI 工具集

xrk-v3-api

编程与开发

查看项目

更新于 11-05 16:20

技能介绍

xrk-v3-api 是一个接口对接与调试技能,主要服务于 /api/v3/chat/completions 和 /api/v3/models 两个接口的使用与问题排查。

用途:用于对接、调试兼容 OpenAI Chat Completions 约定的对话接口,覆盖普通响应与 SSE 流式输出场景,同时涉及 multipart 多模态上传和 workflow 工具白名单配置。

主要能力:

  • POST /api/v3/chat/completions 与 GET /api/v3/models,实现位于 core/system-Core/http/ai.js。
  • 入参/出参兼容 OpenAI Chat Completions,SSE 流式输出包含 [DONE] 结束标记。
  • model 字段即 provider key。
  • workflow.workflows 与 workflow.streams 用于配置 MCP 工具白名单。
  • multipart 上传时 messages 以 JSON 字符串传递,image/* 转为 base64 并并入最后一条 user 消息。

使用方式:出站 LLM 请求使用全局 fetch 与 buildFetchOptionsWithProxy;multipart 图片编码使用 toBase64(),资料明确提示不要使用 toString('base64');超时控制使用 AbortSignal.timeout;运行环境为 Node 26。完整 API 表可参考 skill xrk-node-runtime。

排障:401 参考 docs/AUTH.md;无 provider 时检查端口下的 aistream.yaml 或 compat YAML;无工具时检查 enableTools 与 streams 白名单。

适用场景:需要调试流式对话接口、验证多模态图片上传的编码方式、或排查 provider 与工具白名单配置的开发者。

限制:资料未说明收费、价格、支持平台与具体效果;完整 API 细节需参考 xrk-node-runtime 技能资料。