Przejdź do głównej treści
Python SDK nadaje się do usług backendowych, zadań danych, zautomatyzowanych Agentów i skryptów wsadowych. acedatacloud odpowiada za wywołania API, a acedatacloud-x402 za podpisywanie nagłówka żądania PAYMENT-SIGNATURE. Adresy kodu źródłowego i pakietów:

Instalacja zależności

Aby używać upto, należy również jednorazowo wywołać CLI zatwierdzania Permit2, które zależy od web3:
Wynik instalacji i sprawdzenia importów w czystym Python venv:
Opis wyników:
  • Zarówno acedatacloud, jak i acedatacloud-x402 można instalować i importować z PyPI.
  • pip install 'acedatacloud-x402[cli]' dołącza CLI approve-permit2, używane do wstępnego autoryzowania upto.

Przykład Base

Poniższy przykład nie wymaga API Token. Klucz prywatny portfela jest podpisywany wyłącznie lokalnie i nie zostanie wysłany do Ace Data Cloud.
Python SDK obecnie zwraca dict, dlatego przykład używa res["choices"][0]["message"]["content"]. Nie zakładaj bezpośrednio, że z pewnością ma właściwość .choices.

Przykład Solana

Solana używa secret key zakodowanego w base58:
Ścieżka Solana tworzy i przesyła transakcję SPL USDC TransferChecked, a następnie umieszcza podpis transakcji w envelope PAYMENT-SIGNATURE. Płatna ponowna próba Solana zwróciła już HTTP 200 i ADC_SOLANA_E2E_OK w produkcyjnym API. To publiczne zapytanie RPC napotkało ograniczenie szybkości, więc podpis on-chain nie został stabilnie potwierdzony; jeśli potrzebne jest uzgodnienie, użyj własnego Solana RPC do sprawdzenia tej transakcji.

Klient Async

Ten sam payment handler może być używany z AsyncAceDataCloud:

Używanie rozliczania po wykonaniu upto

Rzeczywisty koszt API, takich jak uzupełnienia czatu i wywołania modeli, może być znany dopiero po zakończeniu odpowiedzi. W takim przypadku API może jednocześnie zwracać exact i upto. Aby preferować upto:
Wynik działania programu Base upto:
Potwierdzenie on-chain:
Opis wyników:
  • content ADC_BASE_UPTO_OK wskazuje, że żądanie rzeczywiście dotarło do API modelu.
  • settled value 3 atomic USDC wskazuje, że upto rozlicza się według rzeczywistego użycia, zamiast pobierać pełny limit.
  • settlement tx można otworzyć w BaseScan; podczas uzgadniania zachowaj tx hash, payer, completion id i podsumowanie żądania.
upto używa autoryzacji Permit2 dla limitu, a rzeczywista kwota rozliczenia nie może przekroczyć tego limitu. Przed pierwszym użyciem należy jednokrotnie wykonać approve(Permit2, amount) dla USDC w docelowym łańcuchu. Sposób CLI:
Sposób programowy:
Ten helper jest idempotentny. Jeśli allowance jest już wystarczający, zwróci {"skipped": true} i nie wyśle ponownie transakcji on-chain.

Podpisywanie niskopoziomowe

Jeśli nie używasz SDK, możesz także bezpośrednio wywołać funkcję podpisywania niskiego poziomu:
Funkcje niskiego poziomu nadają się do testów, warstw proxy, integracji z bramami lub nieoficjalnych SDK. W zwykłym kodzie biznesowym w pierwszej kolejności używaj create_x402_payment_handler.