PopNow APIpopnow.ai
API 키 받기

Image Expander API

PopNow

사진을 16:9, 9:16, 1:1 등으로 넓혀 그려요

popnow/image-expander-v1/edit4크레딧부터/장 · US$0.04
Playground에서 써 보기API 키 받기
  • 화면비 7종
  • 이미지 확장

Image Expander 소개

사진을 새 화면비로 넓힙니다. 자르거나 늘리지 않고 원본 주위에 새 풍경을 그려 넣습니다.

POST /jobs/createTask에서 모델 이름을 popnow/image-expander-v1/edit(으)로 지정하면 호출할 수 있습니다. 4크레딧/장부터(US$0.04). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
aspect_ratio아니요화면 모양: 가로, 정사각형, 세로. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 기본값: 1:1
image_url예출발점이 되는 이미지.
output_format아니요결과 파일 형식. png · jpeg · webp · 기본값: png

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /장≈ USD
기본3.6US$0.036

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 4크레딧/장(US$0.04)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Image Expander API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 popnow/image-expander-v1/edit, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 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": "popnow/image-expander-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "aspect_ratio": "1:1",
    "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 탭에 있어요.

Image Expander API 질문

Image Expander API 요금은 얼마인가요?

Image Expander 가격은 4크레딧(US$0.04) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Image Expander의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 이미지 확장: popnow/image-expander-v1/edit을(를) 넣으세요.

새 영역에 무엇을 그릴지 정할 수 있나요?

아닙니다. 프롬프트 필드가 없으며 확장 영역은 사진에 이미 있는 것을 이어 갑니다.

결과 크기는 어떻게 되나요?

긴 변은 항상 1536픽셀이고 짧은 변은 고른 비율을 따릅니다. 16:9는 1536 × 864, 9:16은 864 × 1536, 1:1은 1536 × 1536입니다.

어떤 비율을 골라야 하나요?

쓸 곳에 맞추십시오. 영상 커버와 헤더는 16:9, 스토리와 릴스는 9:16, 피드와 쇼핑몰 타일은 1:1, 인쇄풍 레이아웃은 3:2나 2:3입니다.

Image Expander API의 제한은 무엇인가요?

화면 비율: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 Image Expander을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 Image Expander을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

Image Expander 더 알아보기