API Reference

随机提示词 API 文档

服务基于本仓库 cases/*.md 启动时解析数据，不需要数据库。默认地址为 http://127.0.0.1:3000。

接口列表

GET /health

服务状态

返回服务状态、提示词总数和各类型数量。

GET /api/types

类型列表

返回可用类型列表。当前基础类型包括 ad-creative、character、comparison、ecommerce、portrait、poster、ui。

GET /api/random?type=poster

按查询参数随机

按查询参数获取指定类型的一条随机提示词。也支持中文别名，例如 type=海报、type=电商、type=人像。

GET /api/random/poster

按路径随机

按路径参数获取指定类型的一条随机提示词，适合前端路由或更简洁的调用。

GET /images/<path>

图片资源

访问随机结果中的本地输出图片，例如 /images/poster_case1/output.jpg。

响应示例

{
  "type": "poster",
  "total": 101,
  "item": {
    "id": 130,
    "title": "Dance Movement Reference Sheet",
    "sourceUrl": "https://x.com/...",
    "creator": {
      "name": "@creator",
      "url": "https://x.com/creator"
    },
    "prompt": "...",
    "imagePath": "images/poster_case130/output.jpg",
    "imageUrl": "/images/poster_case130/output.jpg"
  }
}

调用示例

curl -sS http://127.0.0.1:3000/api/types
curl -sS http://127.0.0.1:3000/api/random/poster
curl -sS 'http://127.0.0.1:3000/api/random?type=海报'

错误格式

类型缺失或无效时返回 HTTP 400，并给出可用类型列表。

{
  "error": "Invalid or missing type",
  "validTypes": [
    { "type": "poster", "count": 101 }
  ]
}