完整接口中心

当前服务器公开接口目录

这里列出的接口不再是测试期的最小闭环,而是把站点摘要、项目页面清单、素材统计、素材详情和任务查询别名都纳入统一入口。

接口总数:30
GET /

站点首页:真正的网站首页,汇总业务导航、接口能力与项目路由总览。

GET /routes

页面路由总览:展示项目 pages.json 中的本地页面清单,并支持查看单页详情。

GET /routes/:slug

页面路由详情:按页面路由 slug 查看单个业务页面的标题、样式和分类。

GET /apis

接口中心:展示当前服务器的完整接口目录和调用说明。

GET /status

服务状态页:展示服务健康状态、存储模式和业务概览。

GET /assets

素材库管理页:素材管理页别名,方便用更直观的业务路径访问。

GET /admin.html

旧后台入口兼容页:兼容历史后台地址,自动进入素材管理台。

GET /works

作品管理页:管理服务器侧已入库作品,支持查看和删除。

GET /admin-works.html

作品后台兼容页:兼容作品管理的独立后台页地址。

GET /images

图片浏览页:图片浏览页别名,兼容历史测试入口。

GET /tasks

任务中心:用于查询图片生成任务、核对 task_id 和返回状态。

GET /health

健康检查:查看服务在线状态,以及聊天与图片生成链路模式。

GET /v1/site/summary

站点摘要:输出站点业务摘要、路由统计、接口统计和公开配置。

GET /v1/site/routes

项目路由清单:输出 pages.json 解析后的页面清单、分组和统计信息。

GET /v1/site/apis

接口清单:输出当前服务器公开接口清单和说明。

GET /v1/assets

素材列表:按用户、类型、来源、库名与关键词筛选素材记录。

GET /v1/assets/stats

素材统计:输出素材总量、分类分布、来源分布与最近更新时间。

GET /v1/assets/:id

素材详情:根据素材 ID 获取单条素材记录。

GET /v1/works

作品列表:输出服务器侧作品记录,支持按类型、来源、关键词筛选。

GET /v1/works/stats

作品统计:输出作品总量、类型分布、来源分布与最近更新时间。

GET /v1/works/:id

作品详情:根据作品 ID 获取单条服务器侧作品记录。

POST /v1/assets

保存素材:保存图片或文本类素材到自建素材库。

DELETE /v1/assets/:id

删除素材:根据素材 ID 删除记录。

DELETE /v1/works/:id

删除作品:删除作品记录,并尽量清理服务器 uploads 中对应文件。

POST /v1/assets/store-image

落库存图并登记:下载远程图片到本地 uploads,并写入素材库记录。

POST /v1/store-image

仅落库存图:下载远程图片到本地 uploads,但不额外登记素材记录。

POST /v1/chat/completions

对话生成:OpenAI 兼容的聊天补全接口,供本地和正式站统一接入。

POST /v1/generate

图片生成:提交图片生成任务,支持 mock 和代理两种模式。

POST /v1/task/query

任务查询:按 task_id 查询异步图片任务进度。

GET /v1/tasks/:id

任务查询别名:以更标准的 REST 风格查询异步图片任务详情。