Skip to content

文档与注释错误(关于 AI 插画过滤参数) #410

Description

@ouhongtao2024

问题描述

在使用 PixivpyAppPixivAPI.search_illust 方法时,发现关于 search_ai_type 参数的注释和文档存在错误,可能导致用户误将人类原创插画排除在搜索结果之外。

相关代码

result = api.search_illust(
    keyword,
    search_target="partial_match_for_tags",
    search_ai_type=1
)

当前部分注释错误地写作:

search_ai_type=0 # 过滤 AI 作品(错误)

正确说明

根据 Pixiv 官方 API 的行为及实际测试结果,search_ai_type 参数的值含义应如下:

Image

建议在 Pixivpy 文档中对该参数添加明确注释,防止误导用户。

附加建议:说明返回字段 illust_ai_type 的含义

Pixiv 的插画返回数据中包含字段 illust_ai_type,用于区分作品是否为 AI 生成。

目前观察到的字段取值如下:

Image

实测发现 illust_ai_type=0 和 1 都是由用户手绘上传的原创插画,而 2 表示使用 AI 工具(如 NovelAI、Diffusion 等)生成的作品。

建议在文档中加入此字段说明,方便用户结合结果做二次筛选判断。

建议的文档示例修改

search_ai_type 参数说明(建议添加)

# search_ai_type:
#   0 = 全部作品(包括 AI)
#   1 = 仅原创(排除 AI)
#   2 = 仅 AI 作品

调试信息(用来参考)

  • 一份下载前保存的搜索到的插图的信息
    log.json

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions