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
List user assets
curl --request GET \
--url https://cloud.comfy.org/api/assets \
--header 'X-API-Key: <api-key>'{
"assets": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"size": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"asset_hash": "<string>",
"mime_type": "<string>",
"tags": [
"<string>"
],
"user_metadata": {},
"preview_url": "<string>",
"preview_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_access_time": "2023-11-07T05:31:56Z",
"is_immutable": true
}
],
"total": 123,
"has_more": true
}asset
List user assets
Retrieves a paginated list of assets belonging to the authenticated user. Supports filtering by tags, name, metadata, and sorting options.
GET
/
api
/
assets
List user assets
curl --request GET \
--url https://cloud.comfy.org/api/assets \
--header 'X-API-Key: <api-key>'{
"assets": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"size": 123,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"asset_hash": "<string>",
"mime_type": "<string>",
"tags": [
"<string>"
],
"user_metadata": {},
"preview_url": "<string>",
"preview_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"prompt_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_access_time": "2023-11-07T05:31:56Z",
"is_immutable": true
}
],
"total": 123,
"has_more": true
}承認
API key authentication. Generate an API key from your account settings at https://platform.comfy.org/profile/api-keys. 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 assets to return (1-500)
必須範囲:
1 <= x <= 500Number of assets to skip for pagination
必須範囲:
x >= 0Field to sort by
利用可能なオプション:
name, created_at, updated_at, size, last_access_time Sort order
利用可能なオプション:
asc, desc Whether to include public/shared assets in results
⌘I