API 文档 - EasonSaid

概述

EasonSaid API 是一组免费开放的 HTTP 接口，提供Eason歌词随机获取、高清壁纸随机获取、以及大头仔图标等服务。

所有接口均无需认证（无需 API Key），支持跨域调用（CORS），可直接使用。

💡

EasonSaid API 永久免费开放。如果你觉得有用，欢迎向朋友推荐 EasonSaid 主站！

基础信息

Base URL

BASE https://api.easonsaid.cn

请求方式

所有接口均使用 GET 请求。

跨域支持

所有接口返回 Access-Control-Allow-Origin: * 头，支持任意来源的跨域请求。

响应格式

歌词接口：默认返回纯文本（text/plain），可通过参数切换为 JSON（application/json）
壁纸接口：返回图片流（image/webp、image/jpeg 等）
图标接口：返回图标流（image/x-icon、image/png 等）

快速开始

1. 获取随机歌词

cURL

curl https://api.easonsaid.cn/output.php

返回示例：

200 OK text/plain

“Abyss” 向你分享：“其实人生并非虚耗，何来尘埃飞舞”。它出自：《沙龙》。

2. 在网页中使用壁纸

JavaScript

// 设置随机横屏壁纸为页面背景
document.body.style.backgroundImage =
  "url('https://api.easonsaid.cn/landscape_images.php')";

3. 设置网站图标为大头仔

HTML

<link rel="icon" href="https://api.easonsaid.cn/datouzai_icon.php">

🎵 随机歌词

随机返回一条陈奕迅歌词分享，包含分享者、歌词内容和出处信息。数据来源于 EasonSaid 网站收集的歌词数据库。

请求

GET https://api.easonsaid.cn/output.php

请求参数

参数	类型	必填	默认值	说明
output	string	可选	text	输出格式。`text` 返回纯文本，`json` 返回 JSON 格式

示例请求

cURL

# 纯文本格式（默认）
curl https://api.easonsaid.cn/output.php

# JSON 格式
curl https://api.easonsaid.cn/output.php?output=json

响应示例 - 纯文本格式

200 OK text/plain; charset=utf-8

“Abyss” 向你分享：“其实人生并非虚耗，何来尘埃飞舞”。它出自：《沙龙》。

响应示例 - JSON 格式

200 OK application/json; charset=utf-8

{
  "success": true,
  "data": {
    "id": 1,
    "Contents": "其实人生并非虚耗，何来尘埃飞舞",
    "Source": "沙龙",
    "Contributors": "Abyss",
    "Time": "2025-10-29",
    "LyricShareCount": 1,
    "SongShareCount": 6
  },
  "formatted": "“Abyss” 向你分享：“其实人生并非虚耗，何来尘埃飞舞”。它出自：《沙龙》。"
}

JSON 字段说明

字段	类型	说明
success	boolean	请求是否成功
data.id	integer	歌词记录 ID
data.Contents	string	歌词内容
data.Source	string	歌词出处（歌曲名）
data.Contributors	string	分享者名称
data.Time	string	分享时间
data.LyricShareCount	integer	分享这句歌词的人数
data.SongShareCount	integer	这首歌一共被分享了几次
formatted	string	格式化后的完整文本

前端调用示例

JavaScript (Fetch API)

async function getRandomLyrics() {
  const response = await fetch('https://api.easonsaid.cn/output.php?output=json');
  const data = await response.json();

  if (data.success) {
    console.log(`分享者: ${data.data.Contributors}`);
    console.log(`歌词: ${data.data.Contents}`);
    console.log(`出处: ${data.data.Source}`);
    // 或直接使用格式化文本
    console.log(data.formatted);
  }
}

getRandomLyrics();

Python

import requests

response = requests.get('https://api.easonsaid.cn/output.php')
print(response.text)
# 输出: “Abyss” 向你分享：“其实人生并非虚耗，何来尘埃飞舞”。它出自：《沙龙》。

# JSON 格式
data = requests.get('https://api.easonsaid.cn/output.php?output=json').json()
print(data['data']['Contents'])

🖼️ 横屏壁纸

随机返回一张横屏（landscape）高清壁纸图片。每次请求返回不同的图片，直接以图片流输出，不缓存。

请求

GET https://api.easonsaid.cn/landscape_images.php

请求参数

无。直接访问 URL 即可获取随机图片。

响应

属性	说明
Content-Type	图片 MIME 类型（`image/webp`、`image/jpeg`、`image/png`、`image/gif`）
Cache-Control	`no-cache, must-revalidate`（不缓存）

使用方式

HTML / CSS / JavaScript

<!-- 直接在 img 标签中使用 -->
<img src="https://api.easonsaid.cn/landscape_images.php" alt="随机横屏壁纸">

/* CSS 背景图 */
.hero {
  background: url('https://api.easonsaid.cn/landscape_images.php') center/cover;
}

// JavaScript 动态设置
document.body.style.backgroundImage =
  "url('https://api.easonsaid.cn/landscape_images.php?t=" + Date.now() + "')";

✅

壁纸接口返回的图片支持 <img> 标签、CSS background-image、以及 fetch() 等多种方式使用。

📱 竖屏壁纸

随机返回一张竖屏（portrait）高清壁纸图片，适用于手机壁纸或移动端背景。行为与横屏壁纸接口一致。

请求

GET https://api.easonsaid.cn/portrait_images.php

请求参数

无。直接访问 URL 即可获取随机图片。

响应

与横屏壁纸接口相同，返回图片流。

使用方式

JavaScript - 根据屏幕方向自动切换

function setRandomBackground() {
  const isPortrait = window.innerHeight > window.innerWidth;
  const baseUrl = isPortrait
    ? 'https://api.easonsaid.cn/portrait_images.php'
    : 'https://api.easonsaid.cn/landscape_images.php';

  document.body.style.backgroundImage =
    `url('${baseUrl}?t=${Date.now()}')`;
}

// 页面加载时设置
setRandomBackground();

// 屏幕旋转时切换
window.addEventListener('orientationchange', setRandomBackground);

😄 大头仔图标

随机返回某个城市的大头仔图标。适合作为网站 favicon 使用。

请求

GET https://api.easonsaid.cn/datouzai_icon.php

请求参数

无。直接访问 URL 即可获取随机图标。

响应

属性	说明
Content-Type	图标 MIME 类型（`image/x-icon`、`image/png`、`image/gif`、`image/webp`）
Cache-Control	`no-cache, no-store, must-revalidate`（完全禁用缓存）

使用方式

HTML

<!-- 将网站图标设为随机大头仔 -->
<head>
  <link rel="icon" href="https://api.easonsaid.cn/datouzai_icon.php">
</head>

JavaScript - 动态切换图标

// 动态更新 favicon
function refreshFavicon() {
  let link = document.querySelector('link[rel="icon"]');
  if (!link) {
    link = document.createElement('link');
    link.rel = 'icon';
    document.head.appendChild(link);
  }
  link.href = `https://api.easonsaid.cn/datouzai_icon.php?t=${Date.now()}`;
}

refreshFavicon();

⚠️

此接口已设置 Cache-Control: no-cache，浏览器每次访问都会获取新图标。如果你需要在 <img> 标签中使用并希望每次都显示不同的图标，建议添加时间戳参数避免浏览器缓存。

常见问题

需要注册或获取 API Key 吗？

不需要。所有接口完全开放，无需任何认证即可调用。

有调用频率限制吗？

目前没有严格的频率限制，但请合理使用，避免过于频繁的请求（建议间隔不低于 1 秒）。我们会根据实际使用情况调整策略。

可以在商业项目中使用吗？

可以。API 免费开放使用，本项目（主站以及API）均已在Github中以MIT协议开源。但请注意歌词内容版权归原作者所有，壁纸图片来源于网络收集。如涉及版权问题，请联系我们处理。

如何获取多条歌词？

目前歌词接口每次只返回一条随机记录。如需多条，可多次调用并自行去重。后续可能会增加批量获取的参数支持。

壁纸图片的分辨率是多少？

横屏壁纸适用于桌面背景（16:9 / 16:10 等比例），竖屏壁纸适用于手机屏幕（9:16 等比例）。图片均为 WebP 格式，文件体积小且质量高。

遇到问题如何反馈？

可通过以下方式联系：

微信：RS-Nocsi
邮箱：3134570359@qq.com

更新日志

2026-06-09

API 文档站上线
开放 output.php 歌词接口，支持 text / json 双格式
开放 landscape_images.php 横屏壁纸接口
开放 portrait_images.php 竖屏壁纸接口
开放 datouzai_icon.php 大头仔图标接口