API 잔액과 환불

PopNow API에는 웹사이트 크레딧과 별개인 전용 USD 잔액이 있습니다. API 키 호출, API 키로 연결한 MCP, Playground는 API USD를 씁니다. OAuth로 연결한 MCP는 계속 웹사이트 크레딧을 씁니다. 같은 모델과 설정에는 API와 웹사이트가 같은 요율을 적용하지만, 잔액을 서로 이체하거나 대신 쓸 수는 없습니다.

이 페이지는 API 입금, 가격, 홀드 해제를 설명합니다. 작업별 홀드, 견적, 한도는 API 결제를 보세요.

1분 만에 보는 API 잔액

• 초기 잔액은 $0입니다. Playground 테스트를 포함해 유료 요청을 실행하기 전에 API billing에서 입금하세요.
• 입금은 별개입니다. 웹사이트 크레딧 팩, 보너스 크레딧과 보상은 API 호출에 쓸 수 없습니다. API 자금은 웹사이트 생성이나 OAuth MCP 호출에 쓸 수 없습니다.
• 실행 전에 견적을 받으세요. jobs/quote는 작업을 시작하지 않고 expectedChargeUsd와 maxChargeUsd를 USD 십진수 문자열로 돌려줍니다.
• 정산 금액을 확인하세요. 작업의 settled가 true이면 costUsd가 최종 USD 청구액입니다. 실패하거나 만료된 작업은 모델별 콘텐츠 거절 요금이 있는 경우를 제외하고 홀드가 자동으로 해제됩니다.

API 자금 입금 방법

API billing에서 현재 활성화된 결제 수단으로 입금하고 결제 내역을 관리하세요. 키 생성과 관리는 별도로 API keys에서 합니다.

웹사이트 크레딧 팩의 보너스, 초대 보상, 기타 웹사이트 크레딧 지급은 API 잔액을 늘리지 않습니다. 웹사이트 팩의 용량, 환불 기간, 유효기간은 API 입금 조건이 아닙니다.

어떤 잔액을 쓰나요

인증 정보와 이용 화면에 따라 결제할 잔액이 정해집니다.

한쪽에 입금해도 다른 쪽 잔액은 늘지 않습니다. API 요청의 홀드 금액이 부족하면 웹사이트 크레딧을 사는 대신 API에 입금하세요.

생성 한 번의 가격이 정해지는 방식

각 모델에는 고유한 가격표가 있으며, 옵션마다 따로 정해집니다. 이미지는 장당, 영상과 오디오는 초당, 음악은 곡당, 음성은 1,000자당 가격이 매겨집니다. 가격은 요청한 내용에 따라 달라집니다. 해상도, 길이, 품질 등급, 그리고 일부 모델의 경우 보내는 참조 파일 수가 기준입니다.

API USD 가격의 예입니다.

모델에서 각 모델 레퍼런스로 이동할 수 있습니다. 설정에 맞는 실시간 견적을 쓰고 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 잔액에서 따로 잡아 둡니다(홀드). 작업이 끝나면 다음과 같습니다.

작업 홀드가 해제되면 사용 가능한 API 자금이 돌아옵니다. 은행이나 카드로 결제 금액이 환불되는 것은 아닙니다. 작업 기록의 costUsd와 settled로 최종 USD 금액을 확인하세요. API 결제를 보세요.

API 결제 환불

API 입금이나 환불에 관한 질문은 API billing을 열거나 고객 지원에 문의하세요. 해당 결제 참조 번호나 작업 ID를 포함하되, API 키는 절대 보내지 마세요.

마주칠 수 있는 오류

모든 코드는 오류에 정리되어 있습니다.

API 호출이 웹사이트에서 생성하는 것보다 비싼가요?

아니요. 같은 모델과 설정에는 같은 요율을 적용합니다. API 호출은 API 잔액에서 USD로 결제하고, 웹사이트 생성과 OAuth MCP는 웹사이트 크레딧을 씁니다. 잔액은 별개입니다.

작업 홀드 해제를 요청해야 하나요?

아니요. 실패하거나 만료된 작업은 모델별 콘텐츠 거절 요금이 있는 경우를 제외하고 홀드가 자동으로 해제됩니다. 정산된 costUsd에서 최종 USD 금액을 확인하세요.

API 입금액을 환불받을 수 있나요?

환불 대상 여부나 API 결제에 관한 도움이 필요하면 API billing을 열거나 고객 지원에 문의하세요.

API 자금에도 웹사이트 크레딧 유효기간이 적용되나요?

웹사이트 크레딧 팩과 보상의 유효기간은 API 조건을 정하지 않습니다. API 자금에 대해서는 API billing을 확인하거나 고객 지원에 문의하세요.

웹사이트 크레딧으로 API에 입금할 수 있나요?

아니요. API billing에서 입금하세요. 웹사이트 크레딧은 API에 쓸 수 없고, API 자금은 웹사이트 생성에 쓸 수 없으며 잔액을 서로 이체할 수도 없습니다.

관련 문서