Skip to main content
POST
为大文件启动后台下载

授权

X-API-Key
string
header
必填

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

请求体

application/json
source_url
string<uri>
必填

要下载的文件的URL(必须来自huggingface.co或civitai.com)

示例:

"https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.safetensors"

tags
string[]

资产的(可选)标签(例如 ["model", "checkpoint"])

user_metadata
object

要附加到资产的可选用户定义元数据

preview_id
string<uuid>

与下载的资产关联的可选预览资产ID

示例:

"550e8400-e29b-41d4-a716-446655440000"

响应

文件已存在于存储中 - 资产立即创建/返回

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

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