---
title: "모델 및 LoRA 검색"
description: "PixAI 모델 마켓을 검색합니다. modelVersionId에 사용할 베이스 모델이나 POST /v2/image/create의 loras에 사용할 LoRA를 찾을 때 사용합니다."
canonical: "https://platform.pixai.art/ko/docs/api-v2/model/searchGenerationModels"
last-updated: "2026-11-02"
---

# 모델 및 LoRA 검색

PixAI 모델 마켓을 검색합니다. `modelVersionId`에 사용할 베이스 모델이나 `POST /v2/image/create`의 `loras`에 사용할 LoRA를 찾을 때 사용합니다.



결과를 사용할 때는 `id`가 아니라 `latestAvailableVersionId`를 전달하세요. 생성 엔드포인트는 **버전** ID를 받습니다. LoRA의 기본 트리거 워드는 `latestAvailableVersion.extra.triggerWords`에 있습니다.

베이스 모델과 호환되는 LoRA를 찾으려면 `usageType=LORA`와 함께 베이스 모델의 유형(모델 항목의 `type`, 예: `SDXL_MODEL`)을 `loraBaseModelTypes`에 보내세요.

결과는 요청자에 따라 다릅니다. API 키를 보내면 계정과 같은 콘텐츠 등급이 적용되며, 익명 요청에는 더 엄격한 필터링이 적용됩니다.

## GET https://api.pixai.art/v2/generation-model/search

Authentication: optional. Send your API key as `Authorization: Bearer <API key>` to read as your account.

Machine-readable OpenAPI spec: https://platform.pixai.art/openapi-spec.v2.ko.yaml

### Parameters

- `usageType` (in query, object (one of the variants below), required)
  `MODEL`은 베이스 모델, `LORA`는 LoRA, `ALL`은 둘 다입니다.
  Allowed values: `ALL`, `MODEL`, `LORA`.
- `keyword` (in query, string, optional)
  자유 텍스트 검색어입니다. 결과는 관련성과 인기도순으로 정렬되며, 키워드가 없으면 인기도순입니다.
  Length: 1 to 256 characters.
- `loraBaseModelTypes` (in query, string, optional)
  `usageType=LORA`와 함께 사용합니다. LoRA가 호환되어야 하는 베이스 모델 유형을 쉼표로 구분해 지정합니다(예: `SDXL_MODEL`).
- `baseModelIds` (in query, string, optional)
  `usageType=LORA`와 함께 사용합니다. LoRA가 호환되어야 하는 베이스 모델 ID를 쉼표로 구분해 지정합니다.
- `source` (in query, string, optional)
  `usageType=LORA`와 함께 사용합니다. `PIXAI`는 PixAI에서 학습한 LoRA, `EXTERNAL`은 외부에서 가져온 LoRA입니다.
  Allowed values: `ANY`, `PIXAI`, `EXTERNAL`.
  Default: `"ANY"`.
- `baseModelType` (in query, string, optional)
  `usageType=MODEL`과 함께 사용합니다. 모델 유형을 쉼표로 구분해 지정합니다(예: `SDXL_MODEL,MMDIT26B_MODEL`).
- `permittedUse` (in query, string, optional)
  라이선스가 이 용도를 허용하는 모델만 반환합니다.
  Allowed values: `COMMERCIAL`, `PERSONAL`.
- `postedWithin` (in query, string, optional)
  Allowed values: `today`, `this-week`, `this-month`.
- `authorId` (in query, string, optional)
  이 사용자의 모델만 반환합니다.
- `size` (in query, integer, optional)
  페이지 크기입니다.
  Default: `24`.
  Range: 1 (exclusive) to 50.
- `offset` (in query, integer, optional)
  건너뛸 결과 수입니다. 페이지가 약간 겹칠 수 있으므로 `id`로 중복을 제거하세요.
  Default: `0`.
  Range: 0 to 10000.

### Responses

- `200`
  결과 한 페이지.
  Body fields:
  - `data` (object[], required)
  - `data[].id` (string, required)
    모델 ID입니다. 생성 엔드포인트는 버전 ID를 받으므로 `latestAvailableVersionId`를 사용하세요.
  - `data[].title` (string, required)
  - `data[].type` (string, required)
    예: `SDXL_MODEL`, `MMDIT26B_MODEL`, `SDXL_LORA`.
  - `data[].category` (string | null, optional)
  - `data[].loraBaseModelTypes` (string[], optional)
    LoRA인 경우 호환되는 베이스 모델 유형.
  - `data[].permittedUse` (string, optional)
    라이선스가 허용하는 용도.
    Allowed values: `PERSONAL`, `COMMERCIAL`.
  - `data[].mediaId` (string | null, optional)
    커버 이미지 미디어 ID.
  - `data[].latestAvailableVersionId` (string | null, optional)
    사용 가능한 최신 버전입니다. `modelVersionId`로 전달하고, LoRA라면 `loras[].modelId`로 전달하세요.
  - `data[].latestAvailableVersion` (object | null, optional)
    사용 가능한 최신 버전.
  - `data[].latestAvailableVersion.id` (string, optional)
    `latestAvailableVersionId`와 같습니다.
  - `data[].latestAvailableVersion.name` (string, optional)
  - `data[].latestAvailableVersion.modelType` (string | null, optional)
  - `data[].latestAvailableVersion.loraBaseModelType` (string | null, optional)
    LoRA인 경우 학습 대상 베이스 모델 유형.
  - `data[].latestAvailableVersion.extra` (object, optional)
    `triggerWords`에 LoRA의 기본 트리거 워드가 들어 있습니다.
  - `data[].latestAvailableVersion.extra.triggerWords` (string, optional)
  - `hasMore` (boolean, required)
    다음 페이지가 있을 수 있는지 여부.