Relight 소개
원하는 조명을 적으면 같은 사진을 다시 비춰 줍니다.
POST /jobs/createTask에서 모델 이름을 popnow/relight-v1/edit(으)로 지정하면 호출할 수 있습니다. 30크레딧/장부터(US$0.03).
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 |
image_url | 예 | 출발점이 되는 이미지. |
output_format | 아니요 | 결과 파일 형식. jpeg · png · webp · 기본값: jpeg |
prompt | 예 | The new light: source, direction, colour and hardness, e.g. "Relight the image with warm golden sunset light from a window on the left." |
seed | 아니요 | 같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.001). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| 기본 | 30 | US$0.03 |
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
Relight API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 popnow/relight-v1/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": "popnow/relight-v1/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",
"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 탭에 있어요.
Relight API 질문
Relight API 요금은 얼마인가요?
Relight 가격은 30크레딧(US$0.03) /장입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.001), 실패한 작업은 환불됩니다.
API에서 Relight의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 조명 바꾸기: popnow/relight-v1/edit을(를) 넣으세요.
빛을 어떻게 설명하면 되나요?
광원, 방향, 색, 강도를 이름으로 적으세요. 예: "warm golden sunset light coming through a window on the left, hard light with window-frame shadows" 또는 "a single hard spotlight from directly above in a dark studio".
인물이나 포즈가 바뀌나요?
아니요. 저희 테스트에서 얼굴, 의상, 포즈, 구도는 유지되었고 빛, 색 보정, 그림자만 바뀌었습니다.
낮을 밤으로 바꿀 수 있나요?
합리적인 범위 안에서 가능합니다. 한낮의 소금 평원 사진은 트럭 헤드라이트가 빛나는 블루 아워가 되었고, 안개 낀 새벽 해변은 황금빛 석양이 되었습니다.
Relight LoRA는 무엇을 더하나요?
같은 사진, 프롬프트, seed로 실행했을 때 LoRA는 기본 모델이 부드럽게만 바꾼 곳에서 더 강하고 방향성 있는 빛과 벽에 드리운 창틀 무늬를 만들었습니다.
Relight API의 제한은 무엇인가요?
화면 비율: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; 프롬프트 길이(글자): 1,000; 최대 업로드 크기: 10 MB. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 Relight을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 Relight을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.