API 잔액과 환불
별도의 API USD 잔액, 모델 요금, 작업 예약 금액 해제, API 결제 환불 문의 방법을 설명합니다.
PopNow API에는 전용 USD 잔액이 있습니다. API 키 호출, 개발자용 MCP, API 페이지의 Playground 실행에 이 잔액이 사용됩니다. 같은 모델과 같은 설정이면 API와 popnow.ai의 가격은 같습니다.
이 페이지에서는 API 입금, 요금, 예약 금액 해제를 설명합니다. 작업별 금액 예약, 견적, 한도는 API 요금 및 결제를 참고하세요.
1분 만에 보는 API 잔액
- 초기 잔액은 $0입니다. Playground 테스트를 포함해 유료 요청을 실행하기 전에 API 결제 관리에서 입금하세요.
- 입금은 API 전용입니다. API 결제 관리에서 추가한 API 자금만 이 잔액에 들어가며, API에서만 사용됩니다.
- 실행 전에 견적을 받으세요.
jobs/quote는 작업을 시작하지 않고expectedChargeUsd와maxChargeUsd를 USD 십진수 문자열로 돌려줍니다. - 정산 금액을 확인합니다. 작업의
settled가true이면costUsd가 최종 USD 청구액입니다. 실패하거나 만료된 작업의 예약 금액은 자동으로 해제됩니다.
API 입금 및 결제 내역
API 결제 관리에서 현재 활성화된 결제 수단으로 입금하고 결제 내역을 관리하세요. 키 생성과 관리는 별도로 API 키에서 합니다.
API 잔액을 쓰는 경우
| 호출 또는 화면 | 결제 잔액 |
|---|---|
sk-popnow- 키를 쓰는 REST 또는 호환 API | API 잔액 |
| API 모델 페이지의 Playground | API 잔액 |
| 개발자용 MCP (API 키) | API 잔액 |
| API 또는 개발자용 MCP로 실행하는 저장한 레시피 | API 잔액 |
API 요청의 예약 금액을 충당할 수 없다면 API 결제 관리에서 API 자금을 추가하세요.
생성 요금 산정 방식
모델마다 옵션별 요금표가 있습니다. 이미지는 장당, 영상과 오디오는 초당, 음악은 곡당, 음성 합성은 1,000자당 요금이 적용됩니다. 해상도, 길이, 품질, 참조 파일에 따라 요금이 달라질 수 있습니다.
API USD 가격의 예입니다.
| 모델 | 결과물 | USD |
|---|---|---|
| Z-Image Turbo | 이미지 한 장 | $0.01 |
| Nano Banana 2.1 | 이미지 한 장, 1K / 2K / 4K | $0.048 / $0.072 / $0.162 |
| Seedream 5.0 Pro | 이미지 한 장, 1K / 2K | $0.036 / $0.072 |
| MiniMax H3 | 이미지→영상, 768p, 5초 | $0.185 |
| Suno v6 | 곡 한 곡 | $0.072 |
| Background Remover | 투명 PNG 한 장 | $0.0048 |
| Image Upscaler | 사진 한 장 업스케일 | $0.012 |
모델에서 각 모델 레퍼런스로 이동할 수 있습니다. 설정에 맞는 실시간 견적을 쓰고 USD 소수 정밀도(소수점 이하 최대 9자리)를 유지하세요. API 청구액은 반올림하지 마세요. API 페이지의 Playground도 같은 API USD 잔액을 씁니다.
생성하기 전에 정확한 금액을 확인합니다.
curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "minimax/h3/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5}}'import os, requests
quote = requests.post(
"https://api.popnow.ai/api/v1/jobs/quote",
headers={"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"},
json={
"model": "minimax/h3/image-to-video",
"input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "prompt": "The waves roll in slowly", "duration_seconds": 5},
},
timeout=30,
).json()["data"]
print(quote["maxChargeUsd"], "USD at most,", quote["expectedChargeUsd"], "USD estimated")const res = await fetch('https://api.popnow.ai/api/v1/jobs/quote', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({
model: 'minimax/h3/image-to-video',
input: { image_url: 'https://media.popnow.ai/movie/lighthouse.webp', prompt: 'The waves roll in slowly', duration_seconds: 5 },
}),
});
const { data } = await res.json();
console.log(`${data.maxChargeUsd} USD at most, ${data.expectedChargeUsd} USD estimated`);작업이 실패하면
작업이 접수되면 발생 가능한 최대 USD 요금이 API 잔액에서 예약됩니다. 작업이 종료되면 다음과 같이 처리됩니다.
| 결과 | 청구 금액 |
|---|---|
succeeded | 예약 금액을 한도로 실제 USD 요금이 청구되며, 사용하지 않은 금액은 해제됩니다 |
failed 또는 expired | 청구되지 않으며 예약 금액이 해제됩니다 |
| 콘텐츠를 이유로 거부됨 | 청구되지 않습니다 |
시작 전에 거부됨(400, 402, 403, 429 …) | 청구되지 않으며 작업 생성이나 금액 예약도 없습니다 |
작업의 예약 금액이 해제되면 API 잔액에서 다시 사용할 수 있습니다. 은행 계좌나 카드로 결제 금액을 환불하는 것은 아닙니다. 작업 기록의 costUsd와 settled로 최종 USD 금액을 확인합니다. API 요금 및 결제를 참고하세요.
API 결제 환불
API 입금이나 환불에 관한 질문은 API 결제 관리을 열거나 고객 지원에 문의하세요. 해당 결제 참조 번호나 작업 ID를 포함하되, API 키는 절대 보내지 마세요.
주요 오류 및 대응 방법
| 코드 | 의미 | 해야 할 일 |
|---|---|---|
40201 | 사용 가능한 API USD 잔액이 작업 예약 금액보다 부족함 | API 결제 관리에서 입금하거나 해상도·길이·출력 수를 줄이세요 |
40202 | 이 작업이 키의 지출 한도 중 하나를 넘게 됨 | API 콘솔에서 한도를 올리거나 없애거나, 초기화될 때까지 기다리세요 |
40901 | 견적을 받은 뒤 가격이 바뀜 | 다시 견적을 받고 새 USD 가격을 보여 주세요 |
모든 코드는 오류에 정리되어 있습니다.
API 호출이 웹사이트에서 생성하는 것보다 비싼가요?
아니요. 같은 모델과 설정에는 같은 요율을 적용합니다. API 호출은 API 잔액에서 USD로 결제됩니다.
작업 예약 금액 해제를 요청해야 하나요?
아니요. 실패하거나 만료된 작업의 예약 금액은 자동으로 해제됩니다. 정산된 costUsd에서 최종 USD 금액을 확인하세요.
API 입금액을 환불받을 수 있나요?
환불 대상 여부나 API 결제에 관한 도움이 필요하면 API 결제 관리을 열거나 고객 지원에 문의하세요.

