요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 · 2:3 · 9:16 · 기본값: 1:1 |
prompt | 예 | Describe the image to generate: subject, composition, style, and lighting. |
reference_image_urls | 아니요 | 결과에 그대로 남길 인물, 의상, 장소의 참조 이미지. |
reference_strength | 아니요 | How strongly the reference images shape the result, from 0 to 1. At 1 the composition can carry over too; lower values mostly keep the palette and texture. ≥ 0 · ≤ 1 · 기본값: 1 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 9 | US$0.09 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Krea 2 Large API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 krea/2-large/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": "krea/2-large/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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 탭에 있어요.
Krea 2 Large API 질문
Krea 2 Large API 요금은 얼마인가요?
Krea 2 Large 가격은 9크레딧(US$0.09) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 Krea 2 Large의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: krea/2-large/text-to-image을(를) 넣으세요.
Large는 Krea 2 Medium, Medium Turbo와 무엇이 다른가요?
셋 다 프롬프트를 받아 이미지 한 장을 돌려줍니다. Large는 가장 느리고 디테일과 재질의 상한이 가장 높습니다. Medium Turbo는 빠른 등급으로, 2.35:1을 포함한 여덟 가지 비율과 스타일 레퍼런스를 Large와 같이 씁니다. Medium은 비율이 다섯 가지이고 레퍼런스 입력이 없지만 png와 jpeg 중에서 고를 수 있습니다.
이 엔드포인트에는 왜 seed가 없나요?
Krea 자체 API에는 있지만 이 엔드포인트에서는 열려 있지 않아, 여기서는 고정할 수 있는 게 없습니다. 남기고 싶은 프레임은 그대로 보관해야 합니다. 다시 돌리면 새 그림이 나오니 프롬프트를 애셋과 함께 저장하세요.
레퍼런스 이미지를 넣을 수 있나요?
넣을 수 있습니다. 최대 열 장이고 선택 항목입니다. 기본 reference_strength 1에서는 색감, 그레인, 재질, 빛에 더해 구도까지 가져옵니다. 주로 색과 질감만 빌리고 싶다면 값을 낮추세요. 0.2에서는 배치가 대체로 프롬프트를 따르지만 스타일은 뚜렷하게 남습니다. 열 장의 비중은 같으니, 거의 똑같은 프레임을 쌓기보다 같은 분위기를 두세 각도로 넣는 편이 낫습니다.
창의성이나 guidance 조절이 있나요?
없습니다. Krea의 창의성 스위치는 네 단계짜리 이산 범주인데 익숙한 숫자 척도로 옮길 공식 대응표가 없습니다. 방향이 어긋난 조절 장치는 없느니만 못해서, 기본 단계를 그대로 씁니다.
프롬프트는 얼마나 길 수 있나요?
최대 5,000자입니다. 필름과 렌즈, 빛의 방향, 재질에 쓰세요. 형용사로 채우기 시작하는 지점이 이 등급에서 묘사가 스스로와 다투기 시작하는 지점입니다.
Krea 2 Large API의 제한은 무엇인가요?
화면 비율: 1:1 · 4:3 · 3:2 · 16:9 · 2.35:1 · 4:5 +2; 참조 이미지: 10; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Krea 2 Large을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Krea 2 Large을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 Krea 모델
Krea 2 Medium Turbo는 같은 프롬프트와 참고를 훨씬 빠르고 저렴하게 쓸 수 있어서 탐색용으로 좋아요. Large는 최종 프레임용이에요.

