---
title: "モデルと LoRA を探して使う"
description: "API から PixAI モデルマーケットを検索し、ベースモデルに合う LoRA を見つけ、トリガーワードとサイズを確認して画像を生成します。"
canonical: "https://platform.pixai.art/ja/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を使用するには？](/ja/docs/quick-start/enroll-in-api)をご参照ください。

<Callout type="info">
  生成エンドポイントが受け取るのは**バージョン** ID です。検索結果の `id` はモデル ID なので、代わりに `latestAvailableVersionId` を渡してください。
</Callout>

手順 [#手順]

<div className="fd-steps">
  <div className="fd-step">
    ベースモデルを選ぶ [#ベースモデルを選ぶ-step]

    [推奨モデル](/ja/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` の各要素が 1 つのモデルです。必要なフィールドは次のとおりです。

    ```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` に、0〜1 の `weight` とともに指定します。

    ```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リクエスト](/ja/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 の検索](/ja/docs/api-v2/model/searchGenerationModels)
* [モデルバージョンの取得](/ja/docs/api-v2/model/getGenerationModelVersion)
* [モデルのバージョン一覧の取得](/ja/docs/api-v2/model/listGenerationModelVersions)
* [モデルバージョンが受け付けるサイズの取得](/ja/docs/api-v2/model/getModelSizeConfig)
* [モデル](/ja/docs/references/models)
