Saltar para o conteúdo principal
Este documento explica como o preço é definido ao chamar a API Ace Data Cloud com X402 e qual é sua relação com o preço normal de Credits (créditos) da plataforma.

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:
Essa taxa de câmbio não é definida arbitrariamente; ela é igual ao preço unitário de Credits da melhor faixa (grande volume) da plataforma. Portanto, pagar com X402 ≈ comprar Credits pelo preço unitário da melhor faixa e depois consumi-los, sem ágio do X402; pelo contrário, você desfruta diretamente do preço unitário de Credits mais barato, sem necessidade de recarga antecipada e sem necessidade de API Token.

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 o cost.amount na 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.
Para detalhes do protocolo sobre esses dois schemes, consulte esquemas de cobrança 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ção upto: 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.
O 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):
Uma solicitação de 500 tokens de prompt + 200 tokens de completion:
O cliente assina com o limite 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), o maxAmountRequired na resposta 402 da solicitação é o valor devido nessa ocasião (consistente com o cost.amount da resposta bem-sucedida, já testado na seção anterior).
  • Cada preço é obtido arredondando para baixo Credits × 0.095215 até 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 o amount 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):
Atenção: pagamento por chamada (Chat / outros serviços acima) e pagamento de pedidos são dois caminhos diferentes. O pagamento por chamada usa uniformemente o preço unitário do melhor nível de 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 (nem Authorization) e leia o accepts[].maxAmountRequired 402 retornado. Esta etapa não gera cobrança. Para APIs exact, ele é o preço final; para APIs upto (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, leia pricing.input_usd / pricing.output_usd de cada modelo (já calculados conforme credit_usd_rate).
  • Validação de conversão: atomic = floor(Credits × 0.095215 × 1e6), USDC = atomic / 1e6 (ou seja, USDC ≈ Credits × 0.095215).
Exemplo mínimo de solicitação para obter o preço:

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 interfaces upto (chat), o valor assinado é o limite superior, com liquidação baseada no uso real.
  • O preço oficial deve considerar o maxAmountRequired retornado pelo 402: em exact, é o valor a pagar (consistente com o cost.amount da resposta bem-sucedida, já testado); em upto, é o limite superior, e o cost.amount da resposta bem-sucedida é o valor real liquidado com base no uso (≤ limite superior).

Documentação relacionada