ReferenceImage (参考图片)

ReferenceImage 模型代表项目中的参考图片，如背景美术、道具设计等。

获取参考图片

for ref_img in project.reference_images():
    print(f"{ref_img.file_name} - {ref_img.category}")

属性

属性	类型	说明
id	str	唯一标识
resource_id	str	资源 ID
category	ReferenceImageCategory	分类
tags	list[str] | None	标签列表
purpose	str | None	用途说明
is_searchable	bool	是否可搜索
sort_order	int	排序序号
file_name	str	文件名
file_size	int	文件大小（字节）
file_url	str	文件下载 URL
mime_type	str	MIME 类型
created_at	datetime	创建时间
updated_at	datetime	更新时间

分类类型

值	说明
ReferenceImageCategory.BACKGROUND_ART	背景美术
ReferenceImageCategory.PROP_DESIGN	道具设计
ReferenceImageCategory.OTHER	其他

方法

save(path) -> None

下载并保存参考图片到本地：

ref_img.save("output/background.png")

save_bytes() -> bytes

获取参考图片的字节数据：

data = ref_img.save_bytes()

使用示例

# 按分类下载所有参考图片
from aimage.search.models.type import ReferenceImageCategory

for ref_img in project.reference_images():
    if ref_img.category == ReferenceImageCategory.BACKGROUND_ART:
        ref_img.save(f"output/bg/{ref_img.file_name}")
    elif ref_img.category == ReferenceImageCategory.PROP_DESIGN:
        ref_img.save(f"output/props/{ref_img.file_name}")