Conclusão Principal
O X402 não é um sistema de preços independente. Cada chamada de API já possui um custo em Credits, que é a única fonte de preço compartilhada por todos os métodos de cobrança (dedução de créditos via API Token, saldo da conta, pagamento on-chain via X402). O X402 apenas converte esse custo em Credits para USDC on-chain a uma taxa de câmbio fixa:
1 Credit = 0.095215 USDC (ou seja, 95215 atomic USDC, sendo que o USDC possui 6 casas decimais)
Ou seja:
Base de Precificação
A conversão é realizada uniformemente pela plataforma, e o valor é consistente em todas as redes compatíveis (Base, Solana); as diferentes redes diferem apenas no contrato de ativo e no método de assinatura, com o mesmo preço.
Relação com o Preço Unitário Normal de Credits
Os Credits da plataforma são vendidos em faixas de “quanto maior o uso, menor o preço unitário”. Ao cobrar por chamada, o X402 utiliza uniformemente o preço unitário da melhor faixa:
Em outras palavras, o X402 liquida cada chamada pelo preço unitário de Credits da melhor faixa. Usuários que compram Credits com pequenas recargas terão um preço unitário maior que o do X402; apenas usuários que fazem grandes recargas terão o mesmo preço unitário do X402.
Duas Formas de Preço: exact e upto
Na resposta 402 do X402, maxAmountRequired é o valor que você precisa assinar. Ele possui duas formas:
exact(preço fixo): o preço pode ser determinado antes de processar a solicitação (imagem, vídeo, música, busca, pagamento de pedido).maxAmountRequired = custo em Credits da chamada × 0.095215, ou seja, o valor devido nessa chamada (consistente com ocost.amountna resposta de sucesso).upto(medição de uso posterior): para APIs como conclusão de chat, nas quais só se sabe quantos tokens foram usados ao final da resposta.maxAmountRequiredé um limite superior (convertido com base no limite de créditos definido para esse modelo: limite de Credits × 0.095215); a liquidação real é feita conforme o uso real, sem exceder o limite.
exact e upto. A seguir, falamos apenas sobre preços.
Preços de Chat (conclusão de chat)
A conclusão de chat usa mediçãoupto: a cobrança é feita com base no uso real de tokens de prompt / completion. O preço por milhão (1M) de tokens = custo em Credits do modelo por 1M de tokens × 0.095215, exatamente consistente com o preço unitário em USD exibido no catálogo público de modelos da plataforma (/api/v1/models?with_pricing=true).
A tabela abaixo mostra os preços reais (obtidos do catálogo de modelos, calculados pela taxa de câmbio X402), em USD / 1M tokens:
Observações:
- A tabela mostra os preços unitários medidos por token; o custo de uma solicitação = tokens de entrada × preço unitário de entrada + tokens de saída × preço unitário de saída.
- O limite
uptoé o valor máximo permitido para assinatura em uma única solicitação desse modelo; ele não é a cobrança real, e a grande maioria das solicitações fica muito abaixo do limite. - O limite determina apenas “quanto pode ser cobrado no máximo”; a liquidação real é calculada conforme o uso de tokens.
Exemplo: cotação e cobrança consistentes (exact)
Abaixo está uma chamada paga real para serp/google usando o X402Client oficial (Base exact). Ela demonstra a consistência entre os três elementos: cotação 402, valor assinado e o cost retornado na resposta de sucesso.
cost.amount retornado (0.000952 USDC) é completamente consistente com a cotação 402 e com Credits × 0.095215. O campo settlement é o status de liquidação deste pagamento (authorized = autorizado); a liquidação on-chain é processada pela plataforma, e o mecanismo está descrito nos planos de cobrança exact e upto.
Cálculo da cotação upto (chat)
O chat é medido por token. A cotação de uma solicitação (não o limite máximo) é calculada pela fórmula abaixo (usando gpt-4o-mini como exemplo):
upto (para gpt-4o-mini, 1 Credit = 95215 atomic), e isso representa apenas o máximo que pode ser cobrado; a cotação real desta solicitação (cerca de $0.0001 no exemplo acima) é muito menor que o limite e é liquidada conforme o uso de tokens. O mecanismo de liquidação on-chain de upto está descrito nos planos de cobrança exact e upto.
Preços de outros serviços (exact de preço fixo)
O preço de APIs como imagem, vídeo, música e busca pode ser determinado no momento da solicitação, usando exact. A tabela abaixo apresenta os preços reais, obtidos a partir de maxAmountRequired 402 retornado por APIs online para solicitações não pagas (consultar a cotação não gera cobrança):
Observações:
- O preço do mesmo serviço varia conforme o modelo, resolução, duração e ação (especialmente para vídeos). A tabela acima apresenta valores reais sob um conjunto específico de parâmetros, apenas como referência de ordem de grandeza.
- Para essas APIs de preço fixo (
exact), omaxAmountRequiredna resposta 402 da solicitação é o valor devido nessa ocasião (consistente com ocost.amountda resposta bem-sucedida, já testado na seção anterior). - Cada preço é obtido arredondando para baixo
Credits × 0.095215até a unidade atomic (consulte a base de precificação acima), usando a mesma conversão do chat. Devido à representação de ponto flutuante e ao arredondamento, valores individuais podem diferir do produto simples em 1 atomic ($0.000001); prevalece sempre o valor retornado pelo 402.
Preço de pagamento de pedidos
Ao usar X402 para pagar pedidos no console (comprar pacotes / recarregar Credits), o preço exibido na página do pedido prevalece, e oamount do 402 é a base final para assinatura. O pagamento de pedidos passa pela API da plataforma e requer um token de conta; consulte o tutorial de pagamento de pedidos.
Um exemplo real no tutorial de pagamento de pedidos (compra de 10 Credits):
0.095215/Credit; o pagamento de pedidos segue o preço do pacote, e a diferença entre seu preço de criação e o valor final de liquidação segue o tutorial de pagamento de pedidos.
Como obter preços em tempo real
Os preços variam conforme o modelo e os parâmetros; obtenha-os em tempo real por programa, sem codificá-los diretamente:- Preço por chamada: envie uma solicitação à API de destino sem
PAYMENT-SIGNATURE(nemAuthorization) e leia oaccepts[].maxAmountRequired402 retornado. Esta etapa não gera cobrança. Para APIsexact, ele é o preço final; para APIsupto(chat), ele é o limite máximo, e o valor real é liquidado conforme o uso. - Preço de chat por token:
GET https://platform.acedata.cloud/api/v1/models?with_pricing=true&type=chat, leiapricing.input_usd/pricing.output_usdde cada modelo (já calculados conformecredit_usd_rate). - Validação de conversão:
atomic = floor(Credits × 0.095215 × 1e6),USDC = atomic / 1e6(ou seja,USDC ≈ Credits × 0.095215).
Resumo
- Preço X402 = o custo em Credits desta chamada ×
0.095215, o mesmo preço da cobrança normal de Credits, apenas liquidado com USDC on-chain. 0.095215/Credit é o preço unitário de Credits da melhor faixa (grande volume) da plataforma; compras de pequenas quantidades de Credits têm um preço unitário mais alto, portanto X402 equivale a obter automaticamente o melhor preço unitário.- Para interfaces
exact(imagem / vídeo / música / busca / pedido), o valor assinado é o valor a pagar nesta chamada; para interfacesupto(chat), o valor assinado é o limite superior, com liquidação baseada no uso real. - O preço oficial deve considerar o
maxAmountRequiredretornado pelo 402: emexact, é o valor a pagar (consistente com ocost.amountda resposta bem-sucedida, já testado); emupto, é o limite superior, e ocost.amountda resposta bem-sucedida é o valor real liquidado com base no uso (≤ limite superior).

