PixAI Platform
API v2 문서모델

모델 및 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
/generation-model/search

Authorization

bearerAuth
AuthorizationBearer <token>

인증이 필요한 모든 요청에는 HTTP 헤더에 다음을 추가하세요

In: header

Query Parameters

usageType*||

MODEL은 베이스 모델, LORA는 LoRA, ALL은 둘 다입니다.

Value in"ALL" | "MODEL" | "LORA"
keyword?string

자유 텍스트 검색어입니다. 결과는 관련성과 인기도순으로 정렬되며, 키워드가 없으면 인기도순입니다.

Length1 <= length <= 256
loraBaseModelTypes?string

usageType=LORA와 함께 사용합니다. LoRA가 호환되어야 하는 베이스 모델 유형을 쉼표로 구분해 지정합니다(예: SDXL_MODEL).

baseModelIds?string

usageType=LORA와 함께 사용합니다. LoRA가 호환되어야 하는 베이스 모델 ID를 쉼표로 구분해 지정합니다.

source?string

usageType=LORA와 함께 사용합니다. PIXAI는 PixAI에서 학습한 LoRA, EXTERNAL은 외부에서 가져온 LoRA입니다.

Default"ANY"
Value in"ANY" | "PIXAI" | "EXTERNAL"
baseModelType?string

usageType=MODEL과 함께 사용합니다. 모델 유형을 쉼표로 구분해 지정합니다(예: SDXL_MODEL,MMDIT26B_MODEL).

permittedUse?string

라이선스가 이 용도를 허용하는 모델만 반환합니다.

Value in"COMMERCIAL" | "PERSONAL"
postedWithin?string
Value in"today" | "this-week" | "this-month"
authorId?string

이 사용자의 모델만 반환합니다.

size?integer

페이지 크기입니다.

Default24
Range1 <= value <= 50
offset?integer

건너뛸 결과 수입니다. 페이지가 약간 겹칠 수 있으므로 id로 중복을 제거하세요.

Default0
Range0 <= value <= 10000

Response Body

application/json

curl -X GET "https://api.pixai.art/v2/generation-model/search?usageType=ALL"
{
  "data": [
    {
      "id": "string",
      "title": "string",
      "type": "string",
      "category": "string",
      "loraBaseModelTypes": [
        "string"
      ],
      "permittedUse": "PERSONAL",
      "mediaId": "string",
      "latestAvailableVersionId": "string",
      "latestAvailableVersion": {
        "id": "string",
        "name": "string",
        "modelType": "string",
        "loraBaseModelType": "string",
        "extra": {
          "triggerWords": "string"
        }
      }
    }
  ],
  "hasMore": true
}