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

이 에셋이 불변인지 여부 (수정 또는 삭제할 수 없음)