크레딧과 결제

API는 popnow.ai와 같은 크레딧을 씁니다. API 전용 요금제도, 구독도, 최소 이용 금액도 없습니다. 필요할 때 크레딧 팩을 사면 되고, 가입할 때 받은 무료 크레딧도 여기서 쓸 수 있습니다.

• 1크레딧 = $0.01(기준 요율). 큰 팩에는 보너스 크레딧이 붙어 크레딧당 가격이 조금 낮아집니다.
• 가격은 모델과 옵션마다 다릅니다. 이미지 장당, 영상·오디오 초당, 요청당, 음성 1,000자당 등이며 모델 페이지마다 나와 있습니다.
• 응답의 금액은 모두 두 가지로 옵니다. 정수 크레딧(credits, maxCredits, availableCredits …)과 미국 달러 문자열(cost, maxCharge, available …)입니다. 크레딧 필드를 쓰세요. 달러 문자열은 회계용입니다.

작업 하나가 청구되는 방식

1. 홀드. createTask가 작업을 접수하면 그 작업이 도달할 수 있는 최고 금액을 잔액에서 잡아 둡니다(estimatedCredits). 잡아 둔 크레딧은 두 번 쓰이지 않지만 아직 청구된 것은 아닙니다.
2. 정산 또는 해제. 작업이 끝나면:
   • succeeded → 실제로 쓴 만큼 냅니다. 정수 크레딧으로 올림하며 홀드 금액을 넘지 않습니다. 나머지는 잔액으로 돌아옵니다.
   • failed 또는 expired → 홀드 전액이 해제되어 비용이 없습니다.

작업 기록에서 진행 상황을 볼 수 있습니다. settled가 false인 동안 credits는 홀드 금액이고, settled가 true가 되면 credits가 최종 청구액입니다.

일부 모델은 제작사가 콘텐츠를 이유로 거절한 요청에도 과금합니다. 이런 경우 모델 페이지에 밝혀 두며, 그 밖의 실패는 무료입니다.

먼저 가격 묻기

POST /api/v1/jobs/quote는 createTask에 보낼 본문 그대로 받아, 아무것도 만들지 않고 크레딧도 잡지 않은 채 가격만 돌려줍니다.

curl -X POST "https://api.popnow.ai/api/v1/jobs/quote" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "alibaba/wan-3.0/image-to-video", "input": {"image_url": "https://media.popnow.ai/movie/lighthouse.webp", "resolution": "720p", "duration_seconds": 5}}'

{
  "code": 200,
  "msg": "success",
  "data": {
    "quoteId": "q_…",
    "model": "alibaba/wan-3.0/image-to-video",
    "maxCredits": 68,
    "expectedCredits": 68,
    "estimatedCost": "0.68",
    "maxCharge": "0.68",
    "currency": "USD",
    "quantity": "5",
    "unit": "per_second",
    "expiresAt": "2026-10-16T09:25:00Z"
  },
  "request_id": "req_…"
}

maxCredits는 이 요청이 쓸 수 있는 최대 금액, 즉 홀드될 금액입니다. expectedCredits는 보통 드는 금액이며, 최종 금액이 결과물(예: 영상의 실제 길이)에 따라 달라질 때만 두 값이 다릅니다.

사용자에게 가격을 보여 준 뒤 실행할 때까지 가격이 바뀌지 않게 하려면, 5분 안에 quoteId와 expectedCredits(보여 준 maxCredits)를 createTask에 함께 보내세요. 그사이 바뀐 게 있으면 createTask가 40901을 돌려주고 아무것도 잡지 않으니 다시 견적을 받으세요.

잔액

curl "https://api.popnow.ai/api/v1/chat/credit" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

availableCredits는 새 작업에 쓸 수 있는 크레딧, heldCredits는 실행 중인 작업에 잡아 둔 크레딧, totalCredits는 둘의 합입니다(available, held, total은 같은 금액의 달러 표시). 경로 이름은 예전 사정 때문이며 채팅과는 관계없습니다. 사용 가능한 잔액으로 새 작업의 홀드를 감당할 수 없으면 createTask가 40201을 돌려줍니다.

사용량

GET /api/v1/usage?from=2026-10-01&to=2026-10-16은 호출한 키 기준으로 작업 수, 성공·실패 수, 쓴 크레딧을 합계(totalCredits), 일별, 모델별로 돌려줍니다. 날짜는 UTC이고 to는 포함하지 않으며 기간은 최대 92일입니다. 정산된 금액만 집계하므로 늦게 끝나는 작업이 있으면 하루 합계가 바뀔 수 있습니다. 이 보고서는 분당 30회로 제한되며, 계정 전체는 API 콘솔의 사용량 페이지에서 보세요.

지출 한도

키마다 API 콘솔에서 일·월·누적 한도를 크레딧 단위로 걸 수 있습니다. 한도를 넘는 요청은 40202를 돌려주고 아무것도 잡지 않습니다. 일 한도는 UTC 00:00, 월 한도는 매월 1일 UTC 00:00에 초기화되며 누적 한도는 초기화되지 않습니다. 따로 정하지 않으면 키에는 한도가 없습니다.

크레딧 구매와 환불

크레딧은 API가 아니라 웹사이트에서 삽니다. 팩과 가격은 요금 페이지에, 환불 대상과 기한은 환불 정책에 있습니다.