workflow
job
asset
- GETList user assets
- POSTUpload a new asset
- POSTCreate asset reference from existing hash
- GETGet asset metadata from remote URL
- POSTInitiate background download for large files
- GETGet asset details
- PUTUpdate asset metadata
- DELDelete asset
- POSTAdd tags to asset
- DELRemove tags from asset
- GETList all tags
- GETGet tag histogram for filtered assets
- HEADCheck if asset exists by hash
user
system
curl --request GET \
--url https://cloud.comfy.org/api/assets/tags/refine \
--header 'X-API-Key: <api-key>'{
"tag_counts": {
"checkpoint": 32,
"lora": 193,
"vae": 6
}
}Get tag histogram for filtered assets
Returns a histogram of tags appearing on assets matching the given filters. Useful for refining asset searches by showing available tags and their counts. Only returns tags with non-zero counts (tags that exist on matching assets).
curl --request GET \
--url https://cloud.comfy.org/api/assets/tags/refine \
--header 'X-API-Key: <api-key>'{
"tag_counts": {
"checkpoint": 32,
"lora": 193,
"vae": 6
}
}授权
API key authentication. Generate an API key from your account settings at https://comfy.org/account. Pass the key in the X-API-Key header.
查询参数
Filter assets that have ALL of these tags
Exclude assets that have ANY of these tags
Filter assets where name contains this substring (case-insensitive)
JSON object for filtering by metadata fields
Maximum number of tags to return (1-1000, default 100)
1 <= x <= 1000Whether to include public/shared assets in results
响应
Success - Tag histogram returned
Map of tag names to their occurrence counts on matching assets
显示 子属性
显示 子属性
{ "checkpoint": 32, "lora": 193, "vae": 6 }