실패한 생성은 차감되지 않습니다

Makernice는 실패한 AI 영상·이미지 생성에 대해 차감하지 않습니다. 생성을 만들면 선불 잔액에서 견적 금액이 보류됩니다. 실행이 완료되면 보류 금액이 차감됩니다. 실행이 실패하거나 시간이 초과되면 보류가 전액 해제됩니다. 생성 전에 입력 검수에서 거부되거나 대기 중에 취소한 경우에도 전액 해제됩니다. 단 하나의 예외: 결과물이 정책 위반으로 검수에서 차단된 경우에는 차감됩니다. 고객 지원에 수동 검토를 요청할 수 있습니다.

API 키 하나로 사용하는 17개 모델 전체에 적용됩니다. 출처: 환불 정책 §2 · API 문서: 가격 및 청구. 최종 확인: 2026년 10월 21일.

2026년 11월 4일 기준 가격입니다 (가격표 v12).

작동 방식: 견적 → 보류 → 차감 또는 해제

1. 견적. POST /v1/generations/quote는 모델, 모드, 해상도, 길이에 맞는 정확한 금액을 반환합니다(영상은 초당, 이미지는 장당 가격). 가격은 12분 동안 고정됩니다(expires_at). 견적 요청에는 비용이 들지 않으며 아무것도 보류되지 않습니다.
2. 보류. quote_id와 함께 POST /v1/generations를 호출하면 해당 금액이 보류됩니다. 잔액이 보류되는 것은 이때뿐이며, 생성이 최종 상태에 도달하면 정산됩니다. 생성은 status: "queued", billing: "held"로 시작합니다. 돈은 잔액에 그대로 있고 예약만 됩니다.
3. 완료 시 차감. 실행이 완료되면 보류 금액이 차감됩니다(billing: "charged"). 결과물을 확인하는 동안 상태는 moderating이며, 파일을 다운로드할 수 있게 되면 succeeded가 됩니다.
4. 실패 시 해제. failed 또는 canceled로 끝나면 보류가 전액 해제됩니다(billing: "released"). 따로 요청하거나 신청할 필요 없이 자동으로 처리됩니다.

보류 해제는 환불이 아닙니다. 돈이 잔액에서 나간 적이 없으므로 환불 요청도, 대기 기간도, 결제 대행사를 거치는 절차도 없습니다.

어떤 경우가 실패한 생성입니까?

환불 정책(§2)과 API 문서 기준:

품질은 실패 조건이 아닙니다. 영상이나 이미지가 제공되면 만족 여부와 관계없이 차감됩니다. 그래서 모든 모델 페이지에서 짧은 저해상도 테스트 실행 비용을 먼저 보여 드립니다.

예시(가격표 v12, 2026년 11월 4일)

API의 금액은 micro-USD 단위의 문자열입니다(1,000,000 = $1.00).

{
  "id": "gen_…",
  "model": "seedance-2.5",
  "status": "failed",
  "amount": "2592000",
  "billing": "released",
  "outputs": [],
  "error": { "code": "timeout", "message": "…" }
}

코드에서 처리하기(Python)

import time, requests

def wait_for(gen_id, headers, api="https://api.makernice.com/v1"):
    while True:
        gen = requests.get(f"{api}/generations/{gen_id}", headers=headers, timeout=15).json()
        if gen["status"] == "succeeded":
            return gen                       # billing == "charged"
        if gen["status"] in ("failed", "canceled"):
            # billing == "released": the full hold is already back in your balance
            raise RuntimeError(f"{gen['status']}: {gen.get('error')}")
        time.sleep(5)                        # queued / generating / moderating / checking

웹훅을 사용하는 경우 generation.failed와 generation.canceled는 보류 금액이 해제된 후에, generation.succeeded는 차감된 후에 전송됩니다. Webhooks를 참고해 주십시오.

중복 차감을 피하고 API 키별 지출 한도를 설정하려면?

• 재시도해도 두 번 차감되지 않습니다. POST /v1/generations에는 Idempotency-Key가 필요합니다. 같은 키, 견적, 입력으로 요청을 반복하면 원래 생성이 반환되며 다시 차감되지 않습니다. (멱등성)
• 키별 지출 한도. API 키마다 지출 한도와 만료일을 설정할 수 있습니다. 키의 한도를 넘게 되는 요청은 금액이 보류되기 전에 402 key_spend_limit_reached로 거부됩니다. 실패하거나 취소된 생성은 키의 지출에 포함되지 않습니다. (인증)

AI 영상 API로 개발하기 전에 확인할 사항

AI 영상 API로 개발을 시작하기 전에 다음을 확인해 보십시오:

1. 실패하거나 시간이 초과된 실행은 차감되는가, 일부만 차감되는가, 차감되지 않는가?
2. 금액은 제출 시 차감되는가, 실행 완료 시 차감되는가?
3. 콘텐츠 검수에서 거부되면 생성 전과 생성 후 각각 비용이 드는가?
4. 대기 중인 작업을 취소할 수 있고, 금액이 돌아오는가?
5. 가격은 실행 전에 고정되는가, 실행 후에 계산되는가?
6. 재시도가 멱등적이어서 네트워크 오류로 두 번 차감되지 않는가?

Makernice의 답: 차감되지 않음 · 실행 완료 시 · 생성 전에는 차감되지 않음(차단된 결과물은 차감됨) · 예, 전액 · 견적으로 12분간 고정 · 예.

자주 묻는 질문

관련 정보

• 요금 — 실시간 단가, $15부터($1,000까지) 충전, 구독 없음
• AI 영상 API 요금 산정 방식(영어) — 가격 = 단가 × 초, 견적은 12분간 고정
• API 문서: 가격 및 청구 · 상태 확인 · 취소 · 멱등성
• 영상 API 모범 사례: 멱등성, 429, 폴링(영어)
• 환불 정책
• 17개 모델 전체