Skip to main content
POST
从现有哈希创建资产引用

授权

X-API-Key
string
header
必填

API密钥认证。从您的用户设置中生成API密钥 位于https://platform.comfy.org/profile/api-keys。在X-API-Key头中传递密钥。

请求体

application/json
hash
string
必填

现有资产的哈希。支持 Blake3 (blake3:) 或 SHA256 (sha256:) 格式

Pattern: ^(blake3|sha256):[a-f0-9]{64}$
tags
string[]
必填

资产的自由格式标签。常见类型包括 "models", "input", "output" 和 "temp",但任何标签都可以按任意顺序使用。

Minimum array length: 1
name
string

资产引用的显示名称(可选)

mime_type
string

资产的 MIME 类型(例如 "image/png", "video/mp4")

user_metadata
object

此资产引用的自定义元数据

响应

资产引用已存在(返回现有引用)

id
string<uuid>
必填

资产的唯一标识符

name
string
必填

资产文件的名称

size
integer<int64>
必填

资产的字节大小

created_at
string<date-time>
必填

资产创建的时间戳

updated_at
string<date-time>
必填

资产最后更新的时间戳

created_new
boolean
必填

这是否为新资产创建(是)或返回已有(否)

asset_hash
string

资产内容的 Blake3 哈希

Pattern: ^blake3:[a-f0-9]{64}$
mime_type
string

资产的 MIME 类型

tags
string[]

与资产关联的标签

user_metadata
object

资产的自定义用户元数据

preview_url
string<uri>

资产预览/缩略图的 URL

preview_id
string<uuid> | null

预览资产的 ID(如有)

prompt_id
string<uuid> | null

创建此资产的任务/提示的 ID(如有)

last_access_time
string<date-time>

资产最后访问的时间戳

is_immutable
boolean

此资产是否为不可变(不能修改或删除)