接口文档 / v1

快速接入

发起 GET 请求即可获取台词。浏览器页面可以直接使用 fetch；跨域请求已开放。

const response = await fetch("https://arkoto.me/api/v1/quotes/random");
if (!response.ok) throw new Error(`Arkoto: ${response.status}`);
const quote = await response.json();
document.querySelector("#quote").textContent =
  `${quote.content} —— ${quote.operator.name}`;

命令行可以用：

curl 'https://arkoto.me/api/v1/quotes/random'

获取台词

每次请求从符合筛选条件的台词中随机取一条。

按北京时间选取当天台词。同一天、同一组筛选条件会得到相同的台词；更换日期或数据快照后可能改变。

筛选参数

两个台词接口都接受以下可选查询参数，也可以组合使用：

# 随机获取阿米娅的台词
curl --get 'https://arkoto.me/api/v1/quotes/random' \
  --data-urlencode 'operator=阿米娅'

# 每天固定获取阿米娅的「任命助理」台词
curl --get 'https://arkoto.me/api/v1/quotes/today' \
  --data-urlencode 'operator=阿米娅' \
  --data-urlencode 'title=任命助理'

在 JavaScript 中用 URLSearchParams 编码中文参数。没有匹配结果时返回 404。

响应字段

{
  "id": "台词 ID",
  "content": "台词正文",
  "operator": { "id": "干员 ID", "name": "干员名称" },
  "title": "任命助理",
  "edition": "CN",
  "date": null,
  "source": "游戏数据来源地址",
  "illustration": {
    "type": "operator_portrait",
    "url": "立绘图片地址",
    "source": "立绘来源地址",
    "filename": "图片文件名"
  }
}

查询干员与场景

按名称搜索干员，返回 { "data": [...] }。q 是可选的名称片段；limit 默认为 50，范围为 1–200，超出范围会被收敛到边界。

返回场景名称和各场景台词数量，结构为 { "data": [{ "title": "任命助理", "line_count": 483 }, ...] }。将 title 传给台词接口即可按场景筛选。

查看台词、干员与立绘数量，以及 imported_at 数据同步时间。

故事留下的画面

随机返回一张剧情 CG 的图片链接和来源。CG 是独立图库，与干员台词没有一一对应关系。

{
  "data": {
    "type": "story_cg",
    "url": "图片地址",
    "source": "图片来源地址",
    "filename": "图片文件名"
  }
}

图片由第三方来源托管，接口只返回链接与文件名。网页中也可以在首页的“故事留下的画面”区块随机浏览。

错误与使用说明

错误响应通常包含 error，部分还包含 message。客户端应检查 HTTP 状态码。接口支持 GET、HEAD、OPTIONS 和跨域读取。

Arkoto 是非官方玩家项目。引用台词或展示立绘时，请保留来源信息并自行确认相关内容的使用范围。公开接口与第三方图片来源均未提供可用性保证。