---
title: "모델과 LoRA 찾아서 사용하기"
description: "API로 PixAI 모델 마켓을 검색하고, 베이스 모델과 호환되는 LoRA를 선택해 트리거 워드와 크기를 확인한 뒤 이미지를 생성합니다."
canonical: "https://platform.pixai.art/ko/docs/quick-start/examples/models-and-loras"
last-updated: "2026-11-17"
---

# 모델과 LoRA 찾아서 사용하기

API로 PixAI 모델 마켓을 검색하고, 베이스 모델과 호환되는 LoRA를 선택해 트리거 워드와 크기를 확인한 뒤 이미지를 생성합니다.





[PixAI 모델 마켓](https://pixai.art/model)의 모든 모델과 LoRA는 API에서 사용할 수 있습니다. 이 가이드에서는 LoRA를 검색하고, 베이스 모델에 맞는지 확인한 뒤, 그 LoRA로 이미지를 생성합니다.

기본 URL: `https://api.pixai.art/v2`. 모델 엔드포인트는 API 키 없이도 사용할 수 있지만, `Authorization: Bearer YOUR_API_KEY`를 보내면 계정에서 보이는 것과 같은 모델이 표시됩니다. 익명 검색은 더 엄격하게 필터링됩니다. 이미지 생성에는 항상 API 키가 필요합니다. [PixAI API를 사용하려면?](/ko/docs/quick-start/enroll-in-api)을 참고하세요.

<Callout type="info">
  생성 엔드포인트에는 **버전** ID를 지정합니다. 검색 결과의 `id`는 모델 ID이므로, 대신 `latestAvailableVersionId`를 보내세요.
</Callout>

단계 [#단계]

<div className="fd-steps">
  <div className="fd-step">
    베이스 모델 선택 [#베이스-모델-선택-step]

    [추천 모델](/ko/docs/references/models#recommended-models) 중 하나에서 시작하거나, `usageType=MODEL`로 베이스 모델을 검색하세요. 버전을 조회하면 모델 유형을 알 수 있으며, LoRA는 이 유형과 일치해야 합니다.

    ```bash
    curl https://api.pixai.art/v2/generation-model-version/1861558740588989558
    ```

    ```json
    {
      "id": "1861558740588989558",
      "modelId": "1861558737426484240",
      "modelTitle": "Haruka v2",
      "modelType": "SDXL_MODEL",
      "status": "available"
    }
    ```

    Haruka v2는 `SDXL_MODEL`이므로 SDXL LoRA를 사용할 수 있습니다.
  </div>

  <div className="fd-step">
    LoRA 검색 [#lora-검색-step]

    `usageType=LORA`, `keyword`, 그리고 `loraBaseModelTypes`에 베이스 모델의 유형을 지정해 검색합니다.

    ```bash
    curl "https://api.pixai.art/v2/generation-model/search?usageType=LORA&keyword=watercolor&loraBaseModelTypes=SDXL_MODEL&size=5" \
      -H "Authorization: Bearer $PIXAI_API_KEY"
    ```

    `data`의 각 항목이 하나의 모델입니다. 필요한 필드는 다음과 같습니다.

    ```json
    {
      "id": "1682965664660673855",
      "title": "Anime Watercolor style XL",
      "type": "MULTI_LORA",
      "loraBaseModelTypes": ["SDXL_MODEL"],
      "permittedUse": "PERSONAL",
      "latestAvailableVersionId": "1682965664694228288",
      "latestAvailableVersion": {
        "id": "1682965664694228288",
        "loraBaseModelType": "SDXL_MODEL",
        "extra": { "triggerWords": "watercolor (medium), (watercolor)" }
      }
    }
    ```

    결과는 관련도와 인기순으로 정렬됩니다. `hasMore`가 `true`인 동안 `offset`과 `size`로 페이지를 넘기세요. 상업적 이용이 가능한 라이선스가 필요하면 `permittedUse=COMMERCIAL`을 추가하세요.
  </div>

  <div className="fd-step">
    버전이 맞는지 확인 [#버전이-맞는지-확인-step]

    `loraBaseModelTypes`는 LoRA의 모든 버전을 포괄하므로, 최신 버전은 다른 베이스 모델용일 수 있습니다. `latestAvailableVersion.loraBaseModelType`이 베이스 모델의 유형과 같은지 확인하세요. 다르다면 해당 유형의 버전 목록을 최신순으로 조회해 첫 번째 `id`를 사용합니다.

    ```bash
    curl "https://api.pixai.art/v2/generation-model/1682965664660673855/versions?baseModelType=SDXL_MODEL"
    ```

    트리거 워드는 `extra.triggerWords`에 있습니다. `triggerWords`에 직접 지정하지 않으면 API가 프롬프트에 자동으로 추가합니다.
  </div>

  <div className="fd-step">
    크기 선택 [#크기-선택-step]

    `aspectRatio`와 `size`는 모든 모델에서 사용할 수 있습니다. 정확한 `width`와 `height`를 지정하려면 베이스 모델이 지원하는 크기를 조회하세요.

    ```bash
    curl https://api.pixai.art/v2/generation-model/1861558740588989558/size-config
    ```

    `ranges`의 각 항목은 `minWidth`–`maxWidth`, `minHeight`–`maxHeight`, 그리고 두 변 모두 배수여야 하는 `step`을 나타내며, 바로 쓸 수 있는 `presets`도 포함합니다. `accessStatus: "membership_required"`인 항목은 더 높은 멤버십 등급이 필요합니다.
  </div>

  <div className="fd-step">
    LoRA로 생성 [#lora로-생성-step]

    LoRA의 버전 ID를 `loras[].modelId`에 넣고, `weight`를 0\~1 사이로 지정합니다.

    ```bash
    curl -X POST https://api.pixai.art/v2/image/create \
      -H "Authorization: Bearer $PIXAI_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "modelVersionId": "1861558740588989558",
        "prompt": "1girl, solo, straw hat, sunflower field, summer, blue sky",
        "aspectRatio": "2:3",
        "loras": [
          { "modelId": "1682965664694228288", "weight": 0.8 }
        ]
      }'
    ```

    그다음 [첫 번째 API 호출](/ko/docs/quick-start/first-api-call)과 같이 `GET /v2/task/{id}`를 폴링하고 결과를 다운로드합니다.

    멤버십 없이는 LoRA를 최대 3개, 멤버십이 있으면 최대 15개까지 조합할 수 있습니다. 이를 초과하면 `403 LORA_NUM_EXCEEDED`가 반환됩니다. `weight`가 높을수록 LoRA의 효과가 강해집니다.
  </div>
</div>

전체 스크립트 [#전체-스크립트]

Haruka v2에 맞는 LoRA를 검색한 뒤, 그 LoRA로 이미지를 생성합니다. 먼저 환경 변수 `PIXAI_API_KEY`를 설정하세요.

<Tabs items="['Python', 'JavaScript']">
  <Tab value="Python">
    `requests`를 설치한 상태에서 실행합니다.

    ```python
    import os
    import time

    import requests

    API = "https://api.pixai.art/v2"
    HEADERS = {"Authorization": f"Bearer {os.environ['PIXAI_API_KEY']}"}
    BASE_VERSION = "1861558740588989558"  # Haruka v2


    def get(path, **params):
        resp = requests.get(f"{API}{path}", headers=HEADERS, params=params)
        resp.raise_for_status()
        return resp.json()


    base = get(f"/generation-model-version/{BASE_VERSION}")
    base_type = base["modelType"]

    results = get(
        "/generation-model/search",
        usageType="LORA",
        keyword="watercolor",
        loraBaseModelTypes=base_type,
        size=10,
    )["data"]

    lora = None
    for model in results:
        latest = model.get("latestAvailableVersion") or {}
        if latest.get("loraBaseModelType") == base_type:
            lora = latest
            break
    if lora is None:
        raise SystemExit(f"No LoRA for {base_type} in the first page of results")
    print("Using", lora["modelTitle"], lora["id"], "trigger words:", lora["extra"].get("triggerWords"))

    resp = requests.post(
        f"{API}/image/create",
        headers=HEADERS,
        json={
            "modelVersionId": BASE_VERSION,
            "prompt": "1girl, solo, straw hat, sunflower field, summer, blue sky",
            "aspectRatio": "2:3",
            "loras": [{"modelId": lora["id"], "weight": 0.8}],
        },
    )
    resp.raise_for_status()
    task = resp.json()

    while task["status"] in ("waiting", "running"):
        time.sleep(2)
        resp = requests.get(f"{API}/task/{task['id']}", headers=HEADERS)
        if resp.status_code == 404:  # 생성 직후의 작업은 잠시 404를 반환할 수 있습니다. 계속 폴링합니다.
            continue
        resp.raise_for_status()
        task = resp.json()

    if task["status"] != "completed":
        raise SystemExit(f"Task ended as {task['status']}: {task.get('taskStatusMsgI18n')}")

    with open("lora.webp", "wb") as f:
        f.write(requests.get(task["outputs"]["mediaUrls"][0]).content)
    ```
  </Tab>

  <Tab value="JavaScript">
    Node.js 20 이상에서 `lora.mjs`로 저장해 실행합니다.

    ```js
    import { writeFile } from 'node:fs/promises';

    const API = 'https://api.pixai.art/v2';
    const HEADERS = {
      Authorization: `Bearer ${process.env.PIXAI_API_KEY}`,
      'Content-Type': 'application/json',
    };
    const BASE_VERSION = '1861558740588989558'; // Haruka v2

    async function call(path, init = {}) {
      const res = await fetch(`${API}${path}`, { headers: HEADERS, ...init });
      if (!res.ok) throw new Error(`${path}: ${res.status} ${await res.text()}`);
      return res.json();
    }

    // 생성 직후의 작업은 잠시 404를 반환할 수 있으므로 계속 폴링합니다.
    async function poll(taskId) {
      const res = await fetch(`${API}/task/${taskId}`, { headers: HEADERS });
      if (res.status === 404) return null;
      if (!res.ok) throw new Error(`/task/${taskId}: ${res.status} ${await res.text()}`);
      return res.json();
    }

    const base = await call(`/generation-model-version/${BASE_VERSION}`);
    const query = new URLSearchParams({
      usageType: 'LORA',
      keyword: 'watercolor',
      loraBaseModelTypes: base.modelType,
      size: '10',
    });
    const { data } = await call(`/generation-model/search?${query}`);
    const lora = data
      .map((model) => model.latestAvailableVersion)
      .find((version) => version?.loraBaseModelType === base.modelType);
    if (!lora) throw new Error(`No LoRA for ${base.modelType} in the first page of results`);
    console.log('Using', lora.modelTitle, lora.id, 'trigger words:', lora.extra?.triggerWords);

    let task = await call('/image/create', {
      method: 'POST',
      body: JSON.stringify({
        modelVersionId: BASE_VERSION,
        prompt: '1girl, solo, straw hat, sunflower field, summer, blue sky',
        aspectRatio: '2:3',
        loras: [{ modelId: lora.id, weight: 0.8 }],
      }),
    });
    while (task.status === 'waiting' || task.status === 'running') {
      await new Promise((resolve) => setTimeout(resolve, 2000));
      task = (await poll(task.id)) ?? task;
    }
    if (task.status !== 'completed') {
      throw new Error(`Task ended as ${task.status}: ${JSON.stringify(task.taskStatusMsgI18n)}`);
    }

    const image = await fetch(task.outputs.mediaUrls[0]);
    await writeFile('lora.webp', Buffer.from(await image.arrayBuffer()));
    ```
  </Tab>
</Tabs>

참고 [#참고]

* [모델 및 LoRA 검색](/ko/docs/api-v2/model/searchGenerationModels)
* [모델 버전 조회](/ko/docs/api-v2/model/getGenerationModelVersion)
* [모델의 버전 목록 조회](/ko/docs/api-v2/model/listGenerationModelVersions)
* [모델 버전이 지원하는 크기 조회](/ko/docs/api-v2/model/getModelSizeConfig)
* [모델](/ko/docs/references/models)
