X402 Opis cenowy

​

Kluczowe wnioski

1 Credit = 0.095215 USDC (czyli 95215 atomic USDC, USDC ma 6 miejsc po przecinku)

Cena X402 (USDC) = Koszt kredytów za to wywołanie × 0.095215

​

Podstawa wyceny

​

Związek z ceną zwykłych kredytów

​

Dwa rodzaje cen: exact i upto

• exact (stała cena): Cena jest znana przed przetworzeniem żądania (obrazy, wideo, muzyka, wyszukiwanie, płatności zamówień). maxAmountRequired = Koszt kredytów za to wywołanie × 0.095215, czyli kwota do zapłaty za to wywołanie (zgodna z cost.amount w udanej odpowiedzi).
• upto (pomiar po zużyciu): Interfejsy takie jak uzupełnianie czatu, gdzie „dopiero po zakończeniu odpowiedzi wiadomo, ile tokenów zostało użytych”. maxAmountRequired to górny limit (przeliczony według ustalonego modelu limitu: limit kredytów × 0.095215), rzeczywiste rozliczenie odbywa się według rzeczywistego zużycia, nie przekraczając górnego limitu.

​

Ceny czatu (uzupełnianie czatu)

• W tabeli przedstawiono ceny jednostkowe według tokenów; koszt jednego żądania = wejście tokenów × cena jednostkowa wejścia + wyjście tokenów × cena jednostkowa wyjścia.
• Górny limit upto to maksymalna kwota, którą można podpisać w jednym żądaniu dla tego modelu; nie jest to rzeczywista kwota do zapłaty, większość żądań jest znacznie poniżej górnego limitu.
• Górny limit decyduje tylko o „maksymalnej możliwej kwocie do odjęcia”, rzeczywiste rozliczenie odbywa się według zużycia tokenów.

​

Przykład: Cena i opłata są zgodne (exact)

# 1) Żądanie bez płatności -> 402, uzyskanie wyceny (bez opłaty)
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215, zaokrąglone w dół do atomic = 952

# 2) Podpisanie 952 atomic PAYMENT-SIGNATURE z portfela, ponowne próby
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 接口（聊天）它是上限，实际按用量结算。
• 聊天每 token 单价：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 cena = koszt Credits za to wywołanie × 0.095215, i jest to ta sama cena co w przypadku zwykłych Credits, tylko rozliczane w USDC na łańcuchu.
• 0.095215/Credit to najlepsza stawka (duże) Credits; przy małych doładowaniach cena Credits jest wyższa, więc X402 automatycznie uzyskuje najlepszą stawkę.
• Kwota podpisana w interfejsie exact (zdjęcia / wideo / muzyka / wyszukiwanie / zamówienia) to kwota do zapłaty; w interfejsie upto (czat) podpisana jest górna granica, rozliczane według rzeczywistego zużycia.
• Autorytatywna cena opiera się na maxAmountRequired zwróconym przez 402: exact to kwota do zapłaty (zgodna z cost.amount w odpowiedzi sukcesu, potwierdzone); upto to górna granica, a cost.amount w odpowiedzi sukcesu to rzeczywista kwota rozliczana według zużycia (≤ górna granica).

​

Powiązane dokumenty