가이드: 이미지 생성과 편집

이미지는 가장 빠르고 가장 싸게 만들 수 있어 API를 익히기에 제일 좋습니다. 대부분의 이미지 모델은 1분 안에 끝나므로 ?wait=60을 붙이면 같은 응답에서 그림을 받을 수 있습니다.

텍스트로 이미지

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "black-forest-labs/flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Product photo of a ceramic coffee mug on a linen tablecloth, soft window light, shallow depth of field",
      "aspect_ratio": "4:3"
    }
  }'

결과는 data.output.assets[0].url에 있습니다. 202가 오면 모델이 60초 넘게 걸렸다는 뜻이니 recordInfo로 작업을 읽으세요.

어떤 모델을 쓸까

가격은 모델과 옵션마다 다릅니다. 모델에 모델별 시작 가격이, 각 레퍼런스 페이지에 모든 구간이 있습니다.

참조 이미지로 편집하기

편집 모델은 /edit로 끝나며, 원본 이미지를 image_urls에 프롬프트에서 언급하는 순서대로 넣습니다.

{
  "model": "google/nano-banana-2.1/edit",
  "input": {
    "prompt": "Turn the scene into a bright summer afternoon and keep the composition",
    "image_urls": ["https://media.popnow.ai/movie/lighthouse.webp"]
  }
}

• 무엇을 바꿀지뿐 아니라 무엇을 그대로 둘지도 쓰세요. 편집 모델은 "얼굴과 자세는 유지"를 글자 그대로 따릅니다.
• 참조 이미지가 여러 장이면 위치로 부르세요. "두 번째 이미지의 재킷을 첫 번째 이미지의 사람에게 입혀 줘"처럼요.
• 로컬 파일은 먼저 업로드하고, 다시 쓸 파일은 에셋 라이브러리에 넣으세요.

한 번에 끝나는 도구

PopNow가 직접 만든 도구는 이미지 한 장만 받고 프롬프트가 필요 없습니다.

{ "model": "popnow/background-remover-v1/edit",
  "input": { "image_url": "https://media.popnow.ai/movie/lighthouse.webp" } }

중요한 설정

• **aspect_ratio**와 **resolution**은 가격을 가장 자주 바꾸는 설정입니다. 헷갈리면 jobs/quote에 물어보세요.
• seed: 생략하면 무작위로 골라 작업의 input에 돌려줍니다. 마음에 든 결과와 비슷한 변형을 원하면 그 숫자를 다시 보내세요. 고정 시드는 비교를 쉽게 할 뿐 똑같은 그림을 보장하지는 않습니다.
• output_format: png는 투명도와 디테일을 살리고 jpeg는 파일이 작습니다.
• 모르는 설정은 거부되니 다른 모델의 설정을 베끼지 말고 그 모델의 스키마를 확인하세요.

잘 먹히는 프롬프트

사진작가나 일러스트레이터에게 의뢰하듯 피사체, 배경, 구도, 빛, 스타일을 적으세요. "도자기 머그컵, 위에서 내려다본 구도, 리넨 천 위, 아침 창가 빛, 차분한 색감"이 "예쁜 머그컵 사진"보다 훨씬 낫습니다. 가장 중요한 것을 맨 앞에 두고, 방향이 엇갈리는 스타일 단어를 길게 나열하지 마세요.

만날 수 있는 오류

• content_rejected: 모델이 프롬프트나 참조 이미지를 거절했습니다. 표현을 바꾸거나 다른 모델을 써 보세요.
• invalid_asset: 참조 이미지를 읽지 못했습니다. URL이 이미지 자체를 돌려주는지 확인하거나 파일을 업로드하세요.
• unsupported_combination: 이 모델이 지금 이 설정 조합을 지원하지 않습니다. 메시지에 나온 설정을 바꾸세요.

모두 잡아 둔 크레딧을 돌려주므로 실패한 이미지에는 비용이 들지 않습니다.