PopNowAPI 문서
API 잔액과 결제 내역
본문

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 또는 호환 APIAPI 잔액
API 모델 페이지의 PlaygroundAPI 잔액
개발자용 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}}'
Python
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")
JavaScript
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 결제 관리을 열거나 고객 지원에 문의하세요.

이 페이지에서