Skip to content

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

Description

@ouhongtao2024

问题描述

在使用 Pixivpy 的 AppPixivAPI.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

Activity

  1. upbit commented on Jul 6, 2025

    @upbit
    Owner

    可以帮忙提交个MR,修正下README和代码注释的内容。
    另外,我记得 search_ai_type 外还有个网页用户设置的开关,会屏蔽全部AI作品。不知道这个开关是否受该总开关的影响?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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