Prompt Manager

Local AI Art Collection & Workflow Tool

GitHub Repository
敏感内容展示 (NSFW)

开启后，画廊将显示被标记为敏感的作品。

快速使用指南
上传与记录

支持拖拽上传。对于 Img2Img 作品，可上传多张参考图并拖拽调整顺序。

检索与复用

详情页一键复制 Prompt。支持通过标签组合或关键词快速筛选灵感。

管理与审核

所有作品默认“待审核”。管理员可登录后台进行发布、删除或数据备份。

数据主权

完全本地化运行。支持 ZIP 格式一键全量备份与恢复，轻松迁移。

开发者接口 (API)

本系统提供高性能 RESTful API，支持智能缓存与无限分页模式。
适用于构建第三方客户端、自动化脚本或集成到工作流中。

数据读取 (Read / GET)
1. 画廊数据 (Gallery List)
GET http://prompt.reaicc.com/api/gallery
2. 模板数据 (Templates List)
GET http://prompt.reaicc.com/api/templates
通用筛选参数 (Query Parameters)

适用于上述 GET 接口

参数名 类型 默认值 描述与示例
per_page Int 500 每页数量。支持 -1 开启无限模式（获取全部，上限 1w）。
page Int 1 分页页码。配合返回元数据中的 meta.next_url 可自动翻页。
q String Null 关键词搜索（匹配标题、Prompt或作者）。
例: ?q=cyberpunk
tag String Null 标签筛选。
例: ?tag=二次元
sort String date 排序方式。可选值: date (最新), hot (热度), random (随机)。
响应结构 (Response Example)
{
  "code": 200,
  "message": "success",
  "meta": {
    "page": 1,
    "per_page": 500,
    "total_items": 1280,
    "has_next": true,
    "next_url": "...",
    "server_timestamp": 1715421000
  },
  "data": [
    {
      "id": 1024,
      "title": "Example Art",
      "author": "vioaki",
      "type": "img2img",
      "file_path": "/static/...",
      "prompt": "Masterpiece...",
      "tags": ["tag1", "tag2"],
      "created_at": "2025-12-10"
    }
  ]
}
⚡️ 高级特性：ETag 缓存校验

为了节省带宽并提高轮询效率，API 实现了标准的 ETag / 304 Not Modified 机制。这允许客户端在数据未发生变化时，直接跳过下载过程。

1
首次请求： 服务器返回完整数据，并在 Header 中附带一个唯一指纹：
ETag: "68b329da9893e34099c7d8ad5cb9c940"
2
后续请求： 客户端在 Header 中发送上次收到的指纹：
If-None-Match: "68b329da9893e34099c7d8ad5cb9c940"
3
极速响应： 如果库中数据没有变化（哈希一致），服务器将直接返回 304 Not Modified 状态码，且 不返回任何数据包体 (Body Length = 0)。
数据上传 (Write / POST)
上传接口 (Upload Endpoint)
POST http://prompt.reaicc.com/api/upload

Content-Type 必须为 multipart/form-data

表单参数 (Form Data)
Key Type Req Description
image File 是 主图文件 (jpg/png/gif/webp)
title String 是 作品标题
prompt String 否 提示词内容
author String 否 作者名称，默认"匿名"
description String 否 作品描述
type String 否 txt2img 或 img2img
category String 否 gallery (默认) 或 template
tags String 否 逗号分隔，如 风景,日落
ref_images File[] 否 参考图 (img2img 时使用，可传多个)