X402 가격 설명

​

핵심 결론

1 Credit = 0.095215 USDC (즉, 95215 atomic USDC, USDC는 6자리 소수)

X402 가격 (USDC) = 해당 호출의 Credits 비용 × 0.095215

​

가격 기준

​

일반 Credits 단가와의 관계

​

두 가지 가격 형태: exact와 upto

• exact(고정가): 요청 처리 전에 가격을 확정할 수 있습니다(이미지, 비디오, 음악, 검색, 주문 결제). maxAmountRequired = 해당 호출 Credits 비용 × 0.095215로, 즉 해당 호출의 지불 금액(성공 응답의 cost.amount와 일치).
• upto(사용량 후측정): 채팅 보완과 같은 “응답이 끝나야 얼마나 많은 토큰을 사용했는지 알 수 있는” 인터페이스입니다. maxAmountRequired는 상한입니다(해당 모델에 설정된 상한 금액 환산: 상한 Credits × 0.095215), 실제로는 실제 사용량에 따라 결제되며 상한을 초과하지 않습니다.

​

Chat(채팅 보완) 가격

• 표는 토큰 기준의 단가입니다; 한 번의 요청 비용 = 입력 토큰 × 입력 단가 + 출력 토큰 × 출력 단가.
• upto 상한은 해당 모델의 한 번 요청에서 서명할 수 있는 최대 금액입니다; 실제 청구가 아니며, 대부분의 요청은 상한보다 훨씬 낮습니다.
• 상한은 “최대 얼마를 청구할 수 있는지”를 결정할 뿐, 실제 결제는 토큰 사용량에 따라 계산됩니다.

​

예시: 견적과 청구 일치(exact)

# 1) 미지급 요청 -> 402, 견적을 받음 (청구되지 않음)
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215, 아래로 내림하여 atomic = 952

# 2) 지갑으로 952 atomic의 PAYMENT-SIGNATURE 서명 후 재시도
POST /serp/google (PAYMENT-SIGNATURE) -> 200
body.cost = {"amount": 0.000952, "currency": "usdc", "settlement": "authorized"}

​

upto 견적 계산(채팅)

Credits = 1e-6 × (0.835733 × prompt_tokens + 3.342933 × completion_tokens)
USDC    = Credits × 0.095215

Credits = 1e-6 × (0.835733 × 500 + 3.342933 × 200) ≈ 0.001086 Credits
견적 USDC ≈ 0.001086 × 0.095215 ≈ $0.0001034

​

기타 서비스 가격(고정가 exact)

• 동일한 서비스의 가격은 모델, 해상도, 길이, 동작에 따라 변동합니다(특히 비디오). 위 표는 특정 매개변수 집합에 대한 실제 값으로, 대략적인 참고용입니다.
• 이러한 고정가(exact) 인터페이스에서, 해당 요청의 402 응답에 있는 maxAmountRequired는 해당 결제 금액입니다(성공적인 응답의 cost.amount와 일치하며, 이전 섹션에서 실측됨).
• 각 가격은 Credits × 0.095215를 atomic 단위로 내림하여 얻습니다(위의 가격 기준 참조), 채팅에 사용되는 것과 동일한 변환을 사용합니다. 부동 소수점 표현 및 내림으로 인해 일부 값은 단순 곱셈과 1 atomic($0.000001) 차이가 있을 수 있으며, 항상 402 반환 값을 기준으로 합니다.

​

주문 결제 가격

description Ace Data Cloud Credits x 10.0
created price 1.26          # 주문 생성 가격(USD)
settled    1.20 USDC        # 최종 서명/결제 금액(= 402 amount)
            = 1200000 atomic USDC

​

실시간으로 가격을 얻는 방법

• 호출당 가격: 목표 API에 PAYMENT-SIGNATURE(또는 Authorization 없이) 요청을 한 번 보내고, 반환된 402 accepts[].maxAmountRequired를 읽습니다. 이 단계에서는 요금이 발생하지 않습니다. exact 인터페이스의 경우 최종 가격이며; upto 인터페이스(채팅)의 경우 상한선으로, 실제 사용량에 따라 결제됩니다.
• 채팅 각 토큰 단가: GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat를 통해 각 모델의 pricing.input_usd / pricing.output_usd를 읽습니다(이미 credit_usd_rate에 따라 계산됨).
• 변환 검증: atomic = floor(Credits × 0.095215 × 1e6), USDC = atomic / 1e6(즉, USDC ≈ Credits × 0.095215).

curl -sS -X POST https://x402.acedata.cloud/midjourney/imagine \
  -H 'Content-Type: application/json' \
  -d '{"prompt": "a cat"}'
# 반환 402, accepts[].maxAmountRequired가 해당 호출 가격입니다(exact)

​

요약

• X402 가격 = 해당 호출의 Credits 비용 × 0.095215, 일반 Credits 요금과는 같은 가격이며, 단지 체인 상의 USDC로 정산됩니다.
• 0.095215/Credit는 플랫폼의 최적 등급 (대량) Credits 단가입니다; 소액 충전으로 구매한 Credits 단가는 더 높기 때문에 X402는 자동으로 최적 단가를 얻습니다.
• exact 인터페이스(이미지 / 비디오 / 음악 / 검색 / 주문) 서명 금액은 해당 시점의 지불 금액입니다; upto 인터페이스(채팅) 서명은 상한선으로, 실제 사용량에 따라 정산됩니다.
• 권위 있는 가격은 402가 반환한 maxAmountRequired를 기준으로 합니다: exact는 지불 금액(성공적인 응답의 cost.amount와 일치하며, 실제로 측정됨); upto는 상한선으로, 성공적인 응답의 cost.amount가 사용량에 따라 정산된 실제 금액입니다 (≤ 상한선).

​

관련 문서