api.acedata.cloud w silnie typizowane metody, eliminując potrzebę ręcznego pisania HTTP, SSE, cykli zadań, obsługi błędów i strategii ponownego próbowania.
Rozdział ten jest zorganizowany według rzeczywistej kolejności integracji: najpierw uzyskanie tokena API w konsoli, następnie wybór języka i zapoznanie się z odpowiednim rozdziałem, a na końcu omówienie zaawansowanych zastosowań związanych z cyklem zadań, odpowiedziami strumieniowymi i płatnościami na blockchainie X402.
Repozytorium i pakiety
- Kod źródłowy SDK (monorepo): https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - Klient X402 (TypeScript):
@acedatacloud/x402-client - Klient X402 (Python):
acedatacloud-x402
Macierz możliwości w trzech językach
Zasoby multimedialne SDK Go oraz cykle zadań są obecnie w fazie alpha (wersja pseudov0.0.0-20260505072132-4a3d921f9bb4), stabilną możliwością jestchat.completions. W przypadku scenariuszy multimedialnych zaleca się wybór TypeScript lub Python.
Kiedy używać SDK / MCP / natywnego HTTP / X402
SDK i X402 nie wykluczają się nawzajem: SDK obsługuje zarówno „ścieżkę tokena”, jak i „ścieżkę
paymentHandler”, szczegóły w SDK + X402 płatności hook.
Uzyskiwanie tokena API
Aby używać SDK, najpierw przejdź do Konsoli Ace Data Cloud - Lista aplikacji i uzyskaj token API:
Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zalogowaniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę.
Podczas pierwszego wnioskowania otrzymasz darmowy limit, aby bezpłatnie wypróbować różne usługi AI oferowane przez Ace Data Cloud.
Skopiuj właśnie uzyskany token, poniżej będziemy go nazywać {token}.
Ujednolicone zmienne środowiskowe
SDK w trzech językach automatycznie odczytuje tę samą zmienną środowiskowąACEDATACLOUD_API_TOKEN, zaleca się użycie export w shellu, aby SDK mogło ją automatycznie pobrać:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
Uwaga: W repozytorium projektu AceDataCloud przyjęto konwencjęACEDATACLOUD_API_KEY(w.env/ CI), ale te trzy SDK rozpoznają tylkoACEDATACLOUD_API_TOKEN. Jeśli w twoim środowisku jest tylkoACEDATACLOUD_API_KEY, proszę jawnie przekazać ją podczas tworzenia.
30 sekund do pierwszego przykładu
Poniższe trzy fragmenty kodu wykonują tę samą czynność: wywołujągpt-4o-mini, aby odpowiedział tylko ADC_*_OK. Każdy fragment zawiera rzeczywiste wyniki działania, które możesz powtórzyć używając własnego tokena.
TypeScript
SDK obecnie deklaruje odpowiedź jakoWynik działania programu:Record<string, unknown>, w czasie działania jest to zwykły obiekt JSON, do którego można uzyskać dostęp bezpośrednio przez pola. W projektach TS o ścisłej typizacji, jeśli napotkasz błędy typów, możesz tymczasowo użyćas any, lub zapoznać się z cyklami zadań SDK i odpowiedziami strumieniowymi w celu dostosowania typowanego wrappera.
Python
Python SDK obecnie zwracaWynik działania programu:dict, więc używajres["id"]zamiastres.id. To różni się odopenai-python, na co należy zwrócić uwagę podczas migracji.
Go
Odpowiedzi SDK Go są jednolite jakoWynik działania programu:map[string]any, nie ma silnie typowanych struktur, należy samodzielnie przeprowadzać asercję typów. Wszystkie zasoby są dostępne za pomocą łańcucha metod:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, usage pochodzą z tego samego źródła: autoryzacja przez PlatformGateway → docelowe API zgodne z OpenAI → zapisanie rekordów rozliczeniowych. Pole content to rzeczywiste wyjście modelu, użycie stałego identyfikatora ADC_*_OK ma na celu potwierdzenie, że odpowiedź nie została zmieniona przez SDK.
Zalecana kolejność czytania
- Przewodnik po integracji SDK TypeScript — kod, który można uruchomić po
npm install. - Przewodnik po integracji SDK Python — trzy zestawy zastosowań: synchroniczne, asynchroniczne, strumieniowe.
- Przewodnik po integracji SDK Go — styl Go z
context.Contexti strumieniami kanałów. - Polling zadań SDK i odpowiedzi strumieniowe — różnice jednostkowe TaskHandle, szczegóły implementacji SSE, strategia ponownego próbowania.
- SDK + haki płatności X402 — bez tokena, rozliczenie na podstawie wywołań.
Jak sprawdzić pozostały limit
Możesz sprawdzić aktualny limit konta przez konsolę Ace Data Cloud - lista aplikacji. Możesz sprawdzić całą historię użycia i szczegóły obciążenia przez konsolę Ace Data Cloud - historia użycia.Dowiedz się więcej
- 📦 Kod źródłowy SDK monorepo
- 🔌 Przewodnik po integracji X402
- 🛠 Przewodnik po serwerach MCP
- 📊 Lista usług i ceny

