GD Studio · Controlled Gateway

把音乐元数据请求做成可控的生产接口

UNM Modern 是面向生产的 GD Studio 音乐元数据网关：统一鉴权、来源白名单、缓存、熔断、配额与安全 URL 校验。不代理、不转存、不分发音频文件——只返回经过审查的链接与元数据。

阅读接口文档打开调试台查看端点

合规提醒：部署方需确认非商用/学习边界、版权与署名义务。生产环境必须设置 GD_STUDIO_TERMS_ACCEPTED=true。

设计原则

把“能调通”升级成“可运维、可审计、可限流”的网关能力。

AUTH

API Key 鉴权

/v1/* 默认要求 x-api-key。密钥比对使用哈希 + 常量时间比较，避免明文旁路。

GUARD

上游护栏

来源白名单、全局滚动配额、熔断器与超时共同限制 GD Studio 调用面，缓存命中不消耗配额。

SAFE

安全链接返回

仅返回经协议、凭据、localhost 与私网检查后的 URL。服务本身不下载、不代理媒体内容。

核心端点

浏览器跨域需配置 ALLOWED_ORIGINS；服务端调用只需携带 API Key。

完整文档

GET

/v1/music/sources

返回当前部署允许的音源列表与策略说明。

GET

/v1/music/search

按 source、name、count、page、album 搜索曲目元数据。

GET

/v1/music/url

解析播放链接，支持码率 128/192/320/740/999。

GET

/v1/music/picture · /lyrics

获取封面与歌词；封面尺寸仅允许 300 或 500。

快速开始

本地先确认 Redis（生产必需）与环境变量，再调用搜索接口。

curl -G '__ORIGIN__/v1/music/search' \
  -H 'x-api-key: YOUR_API_KEY' \
  --data-urlencode 'source=joox' \
  --data-urlencode 'name=love' \
  --data-urlencode 'count=5' \
  --data-urlencode 'page=1'