모델과 LoRA 찾아서 사용하기
API로 PixAI 모델 마켓을 검색하고, 베이스 모델과 호환되는 LoRA를 선택해 트리거 워드와 크기를 확인한 뒤 이미지를 생성합니다.
PixAI 모델 마켓의 모든 모델과 LoRA는 API에서 사용할 수 있습니다. 이 가이드에서는 LoRA를 검색하고, 베이스 모델에 맞는지 확인한 뒤, 그 LoRA로 이미지를 생성합니다.
기본 URL: https://api.pixai.art/v2. 모델 엔드포인트는 API 키 없이도 사용할 수 있지만, Authorization: Bearer YOUR_API_KEY를 보내면 계정에서 보이는 것과 같은 모델이 표시됩니다. 익명 검색은 더 엄격하게 필터링됩니다. 이미지 생성에는 항상 API 키가 필요합니다. PixAI API를 사용하려면?을 참고하세요.
생성 엔드포인트에는 버전 ID를 지정합니다. 검색 결과의 id는 모델 ID이므로, 대신 latestAvailableVersionId를 보내세요.
단계
베이스 모델 선택
추천 모델 중 하나에서 시작하거나, usageType=MODEL로 베이스 모델을 검색하세요. 버전을 조회하면 모델 유형을 알 수 있으며, LoRA는 이 유형과 일치해야 합니다.
curl https://api.pixai.art/v2/generation-model-version/1861558740588989558{
"id": "1861558740588989558",
"modelId": "1861558737426484240",
"modelTitle": "Haruka v2",
"modelType": "SDXL_MODEL",
"status": "available"
}Haruka v2는 SDXL_MODEL이므로 SDXL LoRA를 사용할 수 있습니다.
LoRA 검색
usageType=LORA, keyword, 그리고 loraBaseModelTypes에 베이스 모델의 유형을 지정해 검색합니다.
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의 각 항목이 하나의 모델입니다. 필요한 필드는 다음과 같습니다.
{
"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을 추가하세요.
버전이 맞는지 확인
loraBaseModelTypes는 LoRA의 모든 버전을 포괄하므로, 최신 버전은 다른 베이스 모델용일 수 있습니다. latestAvailableVersion.loraBaseModelType이 베이스 모델의 유형과 같은지 확인하세요. 다르다면 해당 유형의 버전 목록을 최신순으로 조회해 첫 번째 id를 사용합니다.
curl "https://api.pixai.art/v2/generation-model/1682965664660673855/versions?baseModelType=SDXL_MODEL"트리거 워드는 extra.triggerWords에 있습니다. triggerWords에 직접 지정하지 않으면 API가 프롬프트에 자동으로 추가합니다.
크기 선택
aspectRatio와 size는 모든 모델에서 사용할 수 있습니다. 정확한 width와 height를 지정하려면 베이스 모델이 지원하는 크기를 조회하세요.
curl https://api.pixai.art/v2/generation-model/1861558740588989558/size-configranges의 각 항목은 minWidth–maxWidth, minHeight–maxHeight, 그리고 두 변 모두 배수여야 하는 step을 나타내며, 바로 쓸 수 있는 presets도 포함합니다. accessStatus: "membership_required"인 항목은 더 높은 멤버십 등급이 필요합니다.
LoRA로 생성
LoRA의 버전 ID를 loras[].modelId에 넣고, weight를 0~1 사이로 지정합니다.
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 호출과 같이 GET /v2/task/{id}를 폴링하고 결과를 다운로드합니다.
멤버십 없이는 LoRA를 최대 3개, 멤버십이 있으면 최대 15개까지 조합할 수 있습니다. 이를 초과하면 403 LORA_NUM_EXCEEDED가 반환됩니다. weight가 높을수록 LoRA의 효과가 강해집니다.
전체 스크립트
Haruka v2에 맞는 LoRA를 검색한 뒤, 그 LoRA로 이미지를 생성합니다. 먼저 환경 변수 PIXAI_API_KEY를 설정하세요.
requests를 설치한 상태에서 실행합니다.
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)Node.js 20 이상에서 lora.mjs로 저장해 실행합니다.
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()));