요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 출발점이 되는 이미지. |
loras | 아니요 | 내 LoRA 파일을 불러와 스타일이나 캐릭터를 고정합니다. 기본값: [] |
output_format | 아니요 | 결과 파일 형식. jpeg · png · webp · 기본값: jpeg |
prompt | 예 | Describe the whole image you want back, not just the change. |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 1.5k · 기본값: 1k |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
strength | 아니요 | 결과가 원본에서 얼마나 멀어져도 되는지. ≥ 0 · ≤ 1 · 기본값: 0.7 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 2.16 | US$0.022 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 3크레딧/장(US$0.03)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Z-Image Base LoRA API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 alibaba/z-image-base-lora/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-base-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
Z-Image Base LoRA API 질문
Z-Image Base LoRA API 요금은 얼마인가요?
Z-Image Base LoRA 가격은 가장 저렴한 이미지 편집 기준 3크레딧(US$0.03) /장부터입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Z-Image Base LoRA의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: alibaba/z-image-base-lora/text-to-image; 이미지 편집: alibaba/z-image-base-lora/edit을(를) 넣으세요.
Base는 Z-Image Turbo와 무엇이 다릅니까?
Turbo는 약 8스텝으로 돌도록 증류했으며, 제작진은 시각적 품질이 가장 높다고 평가합니다. Base는 완전한 모델로, 28~50스텝에 실제 guidance를 쓰고 결과가 더 다양하며, 제작진이 파인튜닝과 LoRA 학습용으로 권하는 빌드입니다. 대신 느려서, 저희 테스트에서는 텍스트→이미지 요청이 보통 30초 안팎 걸렸습니다.
Z-Image Turbo LoRA도 여기서 동작합니까?
안정적으로 동작하지 않습니다. 저희 테스트에서 Turbo로 학습한 픽셀 아트 LoRA는 이 빌드에서 오류 없이 이미지를 무너뜨렸습니다. Z-Image Base로 학습한 LoRA를 쓰십시오.
이미지→이미지에서는 strength를 얼마로 해야 합니까?
스타일 LoRA와 함께 0.6을 쓰면 구도는 유지되고 룩만 바뀝니다. 기본값인 0.7부터는 내용이 바뀌기 시작합니다. 약 0.75부터는 장면의 포즈가 새로 잡히고, 0.85 이상에서는 같은 빛을 가진 새 그림이 나옵니다.
Z-Image Base LoRA API의 제한은 무엇인가요?
해상도: 1K · 1.5K; 프롬프트 길이(글자): 5,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Z-Image Base LoRA을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Z-Image Base LoRA을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Z-Image 모델
Z-Image Turbo LoRA는 훨씬 빠르고 Turbo 빌드용으로 학습한 LoRA에 알맞아요.


