API Reference

接口文档

所有接口统一经由聚合网关 /portal/proxy/<分组>/... 调用。鉴权：请求头 Authorization: Bearer <KEY> 或查询参数 ?key=<KEY>。

歌曲搜索、直链解析、歌词获取。后端 :8899。

GET/portal/proxy/api/search?keyword=孤勇者歌曲搜索

按关键词检索歌曲，返回候选列表与基础元数据。

参数	说明	必填
`keyword`	搜索关键词	必填
`page`	页码，默认 1	可选

示例curl "https://elyisa.cloud/portal/proxy/api/search?keyword=孤勇者&key=YOUR_KEY"

GET/portal/proxy/api/url?id=...直链解析

将歌曲 ID 解析为可播放的音频直链。

参数	说明	必填
`id`	歌曲唯一标识	必填

示例curl "https://elyisa.cloud/portal/proxy/api/url?id=YOUR_SONG_ID&key=YOUR_KEY"

语音合成与歌声转换。后端 :19880。

POST/portal/proxy/v1/tts文本转语音

提交文本与音色参数，返回合成音频。

参数(body)	说明	必填
`text`	待合成文本	必填
`voice`	音色 ID	可选

示例curl -X POST "https://elyisa.cloud/portal/proxy/v1/tts?key=YOUR_KEY" -H "Content-Type: application/json" -d '{"text":"你好，世界"}'

文本到图像封面生成。后端 :19882。

POST/portal/proxy/cover/generate生成封面

提交提示词，返回生成图片地址。

参数(body)	说明	必填
`prompt`	图像描述提示词	必填

示例curl -X POST "https://elyisa.cloud/portal/proxy/cover/generate?key=YOUR_KEY" -H "Content-Type: application/json" -d '{"prompt":"赛博朋克城市夜景"}'

为前端播放器提供只读能力。后端 :8899（/api 前缀）。

GET/portal/proxy/player/search?keyword=...播放器搜索

等同于 api 搜索，便于播放器独立调用。

示例curl "https://elyisa.cloud/portal/proxy/player/search?keyword=晴天&key=YOUR_KEY"

聚合门户提供的元数据与状态接口。

GET/portal/status后端健康状态

返回各内部服务可用性与延迟，无需鉴权。

GET/portal/me?key=...查询 Key 信息

返回应用名称、范围、用量等。