요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
size | 아니요 | Output image size in pixels, written as width*height. All values are native SDXL shapes. 1024*1024 · 896*1152 · 1152*896 · 832*1216 · 1216*832 · 768*1344 · 1344*768 · 기본값: 1024*1024 |
prompt | 예 | Describe the image as comma-separated tags: quality tags first, then subject and wardrobe, then lighting and lens. |
output_format | 아니요 | 결과 파일 형식. png · jpeg · webp · 기본값: png |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 2.25 | US$0.023 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 3크레딧/장(US$0.03)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Prefect Pony XL API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 prefect/pony-xl/text-to-image, 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": "prefect/pony-xl/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"size": "1024*1024",
"output_format": "png"
}
}'
# 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 탭에 있어요.
Prefect Pony XL API 질문
Prefect Pony XL API 요금은 얼마인가요?
Prefect Pony XL 가격은 3크레딧(US$0.03) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Prefect Pony XL의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: prefect/pony-xl/text-to-image을(를) 넣으세요.
프롬프트는 어떻게 씁니까?
쉼표로 구분한 태그형으로, 품질 태그를 맨 앞에 둡니다. 로컬 SDXL 체크포인트와 같은 방식으로 학습해서 그 생태계의 작성 습관이 그대로 통합니다. 긴 서술형 문장도 동작하지만 태그만큼 강하게 조종하지는 못합니다.
같은 이미지를 다시 얻을 수 있습니까?
가능합니다. 같은 시드를 같은 프롬프트, 같은 크기와 함께 넘기십시오. 시드를 빼면 호출마다 다른 장면이 돌아옵니다. 다시 만들 수도 있어야 하는 장면은 시드를 함께 저장해 두십시오.
참조 이미지를 보낼 수 있습니까?
보낼 수 없습니다. 이 엔드포인트는 text-to-image 전용이라 이미지 입력도, 인페인팅도, ControlNet 계열 조건 부여도 없습니다. 이미지를 기점으로 한 편집이 필요하면 카탈로그의 image-to-image 엔드포인트를 쓰십시오.
크기는 무엇이 있고, 왜 이 일곱 가지입니까?
일곱 가지 모두 SDXL 네이티브 픽셀 수입니다. 1024*1024, 896*1152, 1152*896, 832*1216, 1216*832, 768*1344, 1344*768. SDXL 모델에 학습 범위 밖 비율을 요구하면 인체가 무너지기 쉬운 지점이라, 임의의 가로·세로 대신 학습된 형태만 공개합니다.
Prefect Pony XL API의 제한은 무엇인가요?
프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Prefect Pony XL을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Prefect Pony XL을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

