DarumaDocker/models-search-api.md

## models-search-api.md

      
    Raw
  

              models-search-api.md
            
          
    参数释义


参数名
解释


status
模型状态，可选值 init|published，不传返回所有。published 代表已发布前端可见，前端请求时，应该只获取 published 的


trace_status
与 HuggingFace 同步的状态，可选值 tracing | deleted | renamed，不传返回所有。deleted 代表之前从 HF 抓下来过，但现在 HF 上没了；renamed 代表之前从 HF 抓下来过，但现在这个 repo 被作者 rename 或者 transfer 到一个新的 repo 了，此时返回结果的 renamed_to 字段记录的是 repo 的新 id。前端请求时应该只获取 tracing 的。此字段支持传多个值，用逗号分隔，例如：trace_status=deleted,renamed


verified
是否已通过验证，可选值 verified | unreviewed，不传返回所有。


featured
是否被标注 Featured，可选值 ordinary | featured，不传返回所有。


model_type
模型类型，可选值 unknown | embedding | instruct | chat，不传返回所有。此字段支持传多个值，用逗号分隔，例如：model_type=instruct,chat


order
排序，可选值 most_likes | least_likes | most_downloads | least_downloads | most_recent | least_recent | a_z | z_a


offset
分页的起始 offset，假设每页取 10 条记录，第一页为 0，第二页为 10，以此类推


limit
每页取的记录数


search
任意字符串，用来搜索Hugging Face ID，例如 TheBloke/Phind-CodeLlama-34B-v2-GGUF
参数名	解释
status	模型状态，可选值 `init`\|`published`，不传返回所有。`published` 代表已发布前端可见，前端请求时，应该只获取 `published` 的
trace_status	与 HuggingFace 同步的状态，可选值 `tracing` \| `deleted` \| `renamed`，不传返回所有。`deleted` 代表之前从 HF 抓下来过，但现在 HF 上没了；`renamed` 代表之前从 HF 抓下来过，但现在这个 repo 被作者 rename 或者 transfer 到一个新的 repo 了，此时返回结果的 `renamed_to` 字段记录的是 repo 的新 id。前端请求时应该只获取 `tracing` 的。此字段支持传多个值，用逗号分隔，例如：`trace_status=deleted,renamed`
verified	是否已通过验证，可选值 `verified` \| `unreviewed`，不传返回所有。
featured	是否被标注 Featured，可选值 `ordinary` \| `featured`，不传返回所有。
model_type	模型类型，可选值 `unknown` \| `embedding` \| `instruct` \| `chat`，不传返回所有。此字段支持传多个值，用逗号分隔，例如：`model_type=instruct,chat`
order	排序，可选值 `most_likes` \| `least_likes` \| `most_downloads` \| `least_downloads` \| `most_recent` \| `least_recent` \| `a_z` \| `z_a`
offset	分页的起始 offset，假设每页取 10 条记录，第一页为 0，第二页为 10，以此类推
limit	每页取的记录数
search	任意字符串，用来搜索Hugging Face ID，例如 `TheBloke/Phind-CodeLlama-34B-v2-GGUF`