X402 Preço Explicação

​

Conclusão Principal

1 Credit = 0.095215 USDC (ou seja, 95215 atomic USDC, USDC com 6 casas decimais)

Preço do X402 (USDC) = Custo em Credits desta chamada × 0.095215

​

Base de Cálculo

​

Relação com o Preço dos Credits Normais

​

Duas Formas de Preço: exact e upto

• exact (preço fixo): O preço pode ser determinado antes do processamento do pedido (imagens, vídeos, música, pesquisa, pagamento de pedidos). maxAmountRequired = Custo em Credits desta chamada × 0.095215, ou seja, o valor a ser pago nesta chamada (que é consistente com cost.amount na resposta de sucesso).
• upto (medição posterior ao uso): Interfaces como a de completamento de chat, onde “só se sabe quanto token foi usado ao final da resposta”. maxAmountRequired é um limite (calculado com base no limite definido por esse modelo: limite de Credits × 0.095215), e o valor real é liquidado com base no uso real, sem exceder o limite.

​

Preço do Chat (completamento de chat)

• A tabela mostra o preço por token; o custo de uma solicitação = entrada de tokens × preço de entrada + saída de tokens × preço de saída.
• O limite upto é o valor máximo que o modelo permite assinar em uma única solicitação; não é o valor real a ser cobrado, a grande maioria das solicitações fica bem abaixo do limite.
• O limite apenas determina “quanto pode ser cobrado no máximo”, a liquidação real é calculada com base no uso de tokens.

​

Exemplo: Cotação e Cobrança Consistentes (exact)

# 1) Solicitação não paga -> 402, obtendo a cotação (sem cobrança)
POST /serp/google  ->  402
base/exact maxAmountRequired = 952 atomic = $0.000952 = 0.01 Credit
# 0.01 × 0.095215 = 0.00095215, arredondado para baixo para atomic = 952

# 2) Assinando 952 atomic com a carteira, tentando novamente
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 preço = o custo de Créditos desta chamada × 0.095215, e a cobrança de Créditos é o mesmo preço, apenas liquidado em USDC na blockchain.
• 0.095215/Crédito é o preço unitário de Créditos na melhor faixa (grande quantidade); a compra de Créditos em pequenas quantidades tem um preço unitário mais alto, então X402 automaticamente obtém o melhor preço.
• O valor assinado na interface exact (imagem / vídeo / música / pesquisa / pedido) é o valor a ser pago; o valor assinado na interface upto (chat) é o limite, liquidado com base no uso real.
• O preço autoritativo é baseado no maxAmountRequired retornado por 402: exact é o valor a ser pago (consistente com cost.amount da resposta de sucesso, já testado); upto é o limite, o cost.amount da resposta de sucesso é o valor real liquidado com base no uso (≤ limite).

​

Documentos Relacionados