acedatacloud odpowiada za wywołania API, a acedatacloud-x402 za podpisywanie nagłówka żądania PAYMENT-SIGNATURE.
Adresy kodu źródłowego i pakietów:
- Repozytorium SDK: https://github.com/AceDataCloud/SDK
- Repozytorium X402 Client: https://github.com/AceDataCloud/X402Client
- PyPI SDK: https://pypi.org/project/acedatacloud/
- PyPI X402 Client: https://pypi.org/project/acedatacloud-x402/
Instalacja zależności
upto, należy również jednorazowo wywołać CLI zatwierdzania Permit2, które zależy od web3:
- Zarówno
acedatacloud, jak iacedatacloud-x402można instalować i importować z PyPI. pip install 'acedatacloud-x402[cli]'dołącza CLIapprove-permit2, używane do wstępnego autoryzowaniaupto.
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.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: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 zAsyncAceDataCloud:
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:
upto:
content ADC_BASE_UPTO_OKwskazuje, że żądanie rzeczywiście dotarło do API modelu.settled value 3 atomic USDCwskazuje, żeuptorozlicza się według rzeczywistego użycia, zamiast pobierać pełny limit.settlement txmoż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:
{"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:create_x402_payment_handler.
