소개
Qwen Image 2.1 LoRA 편집은 참조 이미지 1~10장을 고치는 동안 직접 만든 LoRA 가중치를 함께 적용합니다. 텍스트→이미지 엔드포인트와 같은 커스텀 가중치 구성을, 빈 화면이 아니라 이미 가지고 있는 작업에 겨눈 것입니다.
가리키는 가중치에 대한 심사도, 결과에 대한 콘텐츠 필터도 없습니다.
출발 소재로 고르는 Qwen Image 2.1 LoRA 모드
| 출발 소재 | 모드 |
|---|---|
| 원본 이미지에 직접 만든 가중치를 더할 때 | Qwen Image 2.1 LoRA 이미지 편집 |
| 브리프에 직접 만든 가중치를 더할 때 | Qwen Image 2.1 LoRA 텍스트-이미지 |
| 커스텀 가중치 없이 편집할 때 | Qwen Image 2.1 이미지 편집 |
핵심 기능 및 하이라이트
진행 중인 작업에 캐릭터 LoRA를 가져오기
새 작업을 시작할 때만 쓸 수 있는 LoRA는 승인된 화면에 적용할 수 있는 LoRA보다 쓸모가 훨씬 적습니다. 이 엔드포인트는 둘 다 받습니다. 한 요청에 참조 이미지 10장까지, 가중치 파일 3개까지입니다.
가중치와 참조 이미지는 일관성의 서로 다른 절반을 맡습니다
참조 이미지는 구도와 배경, 그 특정 화면을 붙잡고, LoRA는 모든 화면에 걸쳐 인물의 동일성을 붙잡습니다. 한쪽에 몰아 기대는 것보다 둘을 함께 쓰는 편이 안정적입니다.
양쪽 모두 무검열
가중치에 대한 심사도, 출력에 대한 필터도 없고, 지시문에서 달리 말하지 않는 한 원본은 그대로 남습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 이 계열에는 네거티브 프롬프트가 없으므로 제외할 내용도 여기에 적습니다. 1자 이상 · 5000자 이하 |
image_urls | 예 | 참조 이미지 1~10장입니다. 모델이 스스로 역할을 배정하지 않으므로 각 원본이 무엇을 맡는지 프롬프트에 적어 주십시오. 1개 이상 · 10개 이하 |
aspect_ratio | 아니요 | 생성 후에 잘라 내는 것이 아니라 생성 전에 구도를 그 비율로 짭니다. 3:1과 21:9의 가로 띠부터 1:3과 9:21의 세로 기둥까지 15가지가 있습니다. |
resolution | 아니요 | 출력 크기와 가격을 정합니다. 1k가 기본값, 1.5k가 그 사이, 2k는 피부 질감과 직물이 버텨 주는 지점입니다. |
loras | 아니요 | 가중치 파일 3개까지, 각각 {path, scale}입니다. path는 .safetensors 파일이나 Hugging Face 저장소로 가는 직접 HTTPS URL이며 저희 쪽에 업로드되는 것도 심사되는 것도 없습니다. 기본값: |
output_format | 아니요 | 기본값은 JPEG입니다. 합성에는 PNG를, 페이지에 바로 올릴 때는 WebP를 쓰십시오. |
seed | 아니요 | 결과를 비슷한 범위 안에 붙잡아 시리즈의 결을 맞춰 줍니다. 재현을 보장하지는 않습니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.042 / 장 |
| $0.078 / 장 |
| $0.15 / 장 |
활용 사례
이미 승인된 컷에 캐릭터 LoRA 적용하기
촬영에서 비싼 부분은 대개 생성이 아니라 모두가 동의한 화면에 도달하는 과정입니다. 이 엔드포인트는 그 화면을 그대로 두고 그 안의 인물을 바꿀 수 있게 합니다. 승인된 구도를 참조로 보내고 캐릭터 LoRA를 불러오면, 조명과 연출과 크롭은 그 자리에 두고 동일성만 가중치가 실어 나릅니다.
과거 작업을 현재의 하우스 스타일로 끌어오기
몇 달 전에 생성한 작업에 스타일 LoRA를 겨누십시오. 옛 화면을 참조로 보내고 스타일 가중치를 적당한 scale로 불러와 다시 돌리면, 오래된 컷과 새 컷이 눈에 띄는 이음매 없이 같은 페이지에 나란히 놓입니다.
직접 만든 참조에서 쌓아 올리는 장면
이미 생성해 둔 인물에서 시작해 두 번째 인물, 의상, 배경을 더하십시오. 지시는 적힌 그대로 수행되고 무검열 가중치도 심사 없이 불러와지므로, 한 번의 프롬프트에 걸지 않고 단계를 나눠 장면을 조립할 수 있습니다.
인물을 고정한 채 의상과 장소 바꾸기
참조 두 장, 하나는 인물을 담고 하나는 의상이나 공간을 담습니다. 여기에 캐릭터 LoRA와 어느 쪽이 무엇인지 적은 프롬프트를 더합니다. 공간을 바꾸고 얼굴은 남기고, 의상을 바꾸고 둘 다 남기십시오.
프롬프트 가이드 및 실전 팁
무엇을 바꿀지보다 참조가 각각 무엇을 맡는지 먼저 적으십시오
모델은 순서나 파일 이름에서 역할을 추론하지 않습니다. 이렇게 적어 주십시오. '첫 번째 이미지는 여성, 두 번째는 그가 서 있는 공간, 세 번째는 코트입니다.' 이 문장이 없으면 여러 장을 넣은 요청은 편집이 아니라 원본을 뒤섞고, 결과는 디버깅할 수 있는 실수가 아니라 평균을 낸 듯한 잔상처럼 보입니다.
프롬프트와 LoRA가 같은 것을 설명하게 두지 마십시오
캐릭터 LoRA를 불러왔다면 얼굴이 아니라 장면과 동작, 빛을 묘사하십시오. 가중치가 이미 담고 있는 특징을 다시 적으면 렌더가 두 방향으로 당겨져 대개 어느 쪽도 아닌 결과가 나옵니다. 동일성은 LoRA가, 그 주변은 프롬프트가 맡게 하십시오.
네거티브 프롬프트가 없으므로 지켜야 할 것은 지시문에 적으십시오
편집 후에도 살아남아야 하는 것을 분명히 적으십시오. '원본과 똑같이 유지하고 의상에 아무것도 더하지 마십시오' 또는 '머리 길이를 바꾸지 마십시오' 같은 식입니다. 판단을 맡겨 두면 편집 모델은 요청하지도 않은 것을 정돈하는데, 무검열 작업에서는 그 정돈이 곧 실패 그 자체입니다.
보내고 나서가 아니라 보내기 전에 값을 확인하십시오
여기에서는 두 가지가 동시에 비용을 움직입니다. 참조 이미지 수와 해상도 단계이고, 그 위에 LoRA 할증이 얹힙니다. 참조 10장에 LoRA 3개를 2k로 돌리는 것이 이 계열이 받는 가장 비싼 조합입니다. 보내기 전 견적이 기준이므로, 단계만으로 가격이 정해진다고 생각하지 말고 큰 요청에서는 그것을 읽으십시오.
배치를 맡기기 전에 새 LoRA가 무언가를 바꾸는지 확인하십시오
다른 기본 아키텍처용으로 만들어진 가중치는 오류 없이 불러와지고도 눈에 보이는 효과가 거의 없을 수 있습니다. 새 가중치에 일부러 티 나는 프롬프트를 한 번 돌려 출력이 달라진 것을 확인한 뒤 배치를 넣으십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-lora/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
