跳到主内容

查询评估报告 · Get Card Review

获取某张角色卡最近一次的 AI 评估报告（生成角色卡评估 的产物）。评估是同步生成的，本接口用于之后随时取回结果，无需重新付费评估。仅作者本人可查询。

接口地址

POST https://xiangcao.ai/api/get-card-review

鉴权

需要在请求头携带 API Key：

Authorization: Bearer <YOUR_API_KEY>

缺少或无效的 Token 会返回 401。只能查询自己创建的角色卡，查询他人的卡会返回 403。

请求体（JSON）

字段类型必填说明
characterIdstring是角色卡 ID。
interface GetCardReviewRequest {
  /** 角色卡 ID */
  characterId: string;
}

响应（JSON）

该卡评估过时，返回与 生成角色卡评估 相同的评估文档（取最新一次）：

字段类型说明
reportobject | null结构化评审报告（overall_score / dimensions / critical_issues / highlights / improvement_priority / summary），结构详见 生成角色卡评估。从未评估过时为 null。
createdAtnumber评估时间戳（毫秒）。未评估过时不返回。
reviewedBystring发起评估的用户 ID。未评估过时不返回。
type GetCardReviewResponse =
  | {
      /** 最近一次评审报告，结构见 gen-card-review 文档 */
      report: CardReviewReport;
      /** 评估时间戳（毫秒） */
      createdAt: number;
      /** 发起评估的用户 ID */
      reviewedBy: string;
    }
  | {
      /** 该卡从未评估过 */
      report: null;
    };

示例

请求：

curl -X POST "https://xiangcao.ai/api/get-card-review" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{ "characterId": "card_abc123" }'

已评估过的响应（节选）：

{
  "report": {
    "overall_score": 7.6,
    "highlights": ["人物性格鲜明，开场白代入感强"],
    "summary": "整体完成度较高……"
  },
  "createdAt": 1752480000000,
  "reviewedBy": "user_001"
}

从未评估过的响应：

{
  "report": null
}

错误处理

出错时返回相应 HTTP 状态码及 JSON：{ "error": "..." }。

状态码说明
400characterId 缺失（'characterId' is required in request body）。
401未携带有效的 Bearer Token，或账号已被封禁。
403该角色卡不属于当前账号。
404角色卡不存在。
500服务端内部错误。

相关接口