CivitAI 图像API与当前站点内容分级系统的兼容性问题分析

问题背景

在CivitAI平台中，用户发现通过官方提供的图像API无法正确识别和获取被标记为NSFW(不适合工作场所)的内容。平台前端界面显示的内容分级系统(PG、PG-13、R、X、XXX)与API文档中描述的NSFW标记方式(nsfw布尔值或'Soft'、'Mature'、'X'等级)存在明显不一致。

技术分析

分级系统差异

CivitAI前端采用五级内容分级：

1. PG
2. PG-13
3. R
4. X
5. XXX

而API文档中描述的却是：

• 简单的nsfw布尔值(true/false)
• 或三个等级：'Soft'、'Mature'、'X'

这种不一致导致开发者无法通过API准确识别和管理不同级别的内容。

API查询问题

用户尝试使用以下Python代码片段查询NSFW内容：

for image in items:
    if image.get('nsfw') in [True, 1] or image.get('nsfwLevel') in ['Soft', 'Mature', 'X']:
        yield image

但未能返回预期结果，即使前端界面显示确实存在被标记为R级的内容。

解决方案

临时解决方法

开发团队确认公共API文档已过时，建议使用以下查询参数获取NSFW内容：

/images?userId=<用户ID>&nsfw=true

获取用户ID可通过/me端点实现。

完整工作流程

1. 首先获取用户ID：

response = requests.get('https://civitai.com/api/v1/me')
user_id = response.json()['id']

2. 然后查询NSFW内容：

response = requests.get(f'https://civitai.com/api/v1/images?userId={user_id}&nsfw=true')
nsfw_images = response.json()['items']

管理建议

目前平台不支持批量删除功能，用户需要：

1. 手动逐一删除不符合要求的内容
2. 或通过前端界面重新评级：
   • 点击图片上的评级按钮
   • 在弹出的对话框中选择正确分级
   • 对错误标签进行投票反馈

未来展望

开发团队已意识到API文档过时的问题，计划在未来更新文档以匹配当前的内容分级系统。建议开发者关注官方更新，同时可使用上述临时方案处理紧急需求。

对于内容分级准确性有异议的用户，建议积极使用平台的反馈机制，帮助改进自动分类系统的准确性。