SuperAPI AI 工具集

uno-overlays-api

智能体与模型

查看项目

更新于 10-16 05:55

技能介绍

用途:通过 overlays.uno 应用 API 控制 UNO 叠加图形,覆盖所有 UNO 应用,支持从单次 HTTP 调用到完整控制网页的集成。

主要能力:可向 UNO 叠加发送显示/隐藏、设置比分、更新文本等命令;支持 Node.js、Python 或浏览器脚本编程控制;可构建网页控制面板;可从外部数据源自动更新叠加。

必要用法:先用 GET https://app.overlays.uno/apiv2/controlapps/{{token}} 获取应用元数据,据 appTemplateId 识别应用(如 473 UNO Soccer、495 UNO Countdown、498 UNO Flipper、503 UNO Playlist、518 UNO Essentials、533 UNO Tennis、586 UNO Badminton、608 UNO Ticker、877 UNO Media Looper、890 UNO Hockey、893 UNO Handball、999 UNO Lucky Draw)。发送命令使用 HTTP PUT https://app.overlays.uno/apiv2/controlapps/{{token}}/api,请求体为含 command 与可选 value 的 JSON,命令区分大小写。所有应用共用 ShowOverlay、HideOverlay、ToggleOverlay、GetOverlayVisibility、GetCustomizationModel、GetCustomization、SetCustomization、SetCustomizationField 等命令。可用 GET https://app.overlays.uno/apiv2/controlapps/{{token}}/api/info 获取 Markdown 文档,用 /api/json 获取结构化命令;REST 模型端点 GET https://app.overlays.uno/apiv2/controlapps/{{token}}/model 可作为最后手段获取完整组合树。输出嵌入或预览使用 outputUrl,不使用 broadcastOutputUrl。

限制与注意:所有端点均受速率限制,免费版每天 10,000 次、25 MB,每分钟 50 次、200 KB;Uno Plus 每天 20,000 次、50 MB,每分钟 200 次、500 KB。超限将静默失败并返回 HTTP 429。响应头 X-Singular-Ratelimit-Burst-Calls 等可用于监控配额,其中 reset 为 Unix 时间戳。建议仅在数据变化时发送,节流循环(免费版建议 ≥2 秒,Uno Plus ≥300 毫秒),剩余量低时退避,429 时暂停并按 reset 重试,保持负载小巧。测试循环、增长的数据负载、多标签页或实例共享限额均为常见陷阱。颜色采用 HTML 格式,布尔值接受 "true"、"1"、"on"、"yes",字符串上限 64 KB。