api.acedata.cloud i starkt typade metoder, vilket sparar tid på att skriva HTTP, SSE, uppgiftspolling, felhantering och återförsök med backoff.
Detta kapitel är organiserat i den ordning som en verklig integration skulle ske: först hämta API-token från konsolen, sedan välja språk och se motsvarande kapitel, och slutligen titta på avancerade användningar av uppgiftspolling, strömmande svar och X402 betalningar på kedjan.
Förråd och paket
- SDK-källkod (monorepo): https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - X402-klient (TypeScript):
@acedatacloud/x402-client - X402-klient (Python):
acedatacloud-x402
Tre språk kapabilitetsmatris
Go SDK:s multimediaresurser och uppgiftspolling är för närvarande i alpha-stadiet (pseudo-versionv0.0.0-20260505072132-4a3d921f9bb4), den stabila kapabiliteten ärchat.completions. För multimedia-scenarier rekommenderas att välja TypeScript eller Python.
När använda SDK / MCP / ren HTTP / X402
SDK och X402 utesluter inte varandra: SDK stöder både “token-väg” och “
paymentHandler-väg”, se SDK + X402 betalningshook.
Ansök om API-token
För att använda SDK, börja med att ansöka om en API-token på Ace Data Cloud-konsolen - Applista:
Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter inloggning kommer du automatiskt att återvända till den aktuella sidan.
Vid första ansökan kommer det att finnas en gratis kvot som gör att du kan prova de olika AI-tjänster som Ace Data Cloud erbjuder.
Kopiera den token du just fått, nedan refereras den som {token}.
Enhetliga miljövariabler
SDK:erna för de tre språken kommer automatiskt att läsa samma miljövariabelACEDATACLOUD_API_TOKEN, det rekommenderas att export i shell så att SDK automatiskt plockar upp den:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
Observera: I AceDataCloud-projektets förråd är det konventionellt att användaACEDATACLOUD_API_KEY(i.env/ CI), men dessa tre SDK:er känner endast igenACEDATACLOUD_API_TOKEN. Om din miljö endast harACEDATACLOUD_API_KEY, vänligen ange den explicit vid konstruktion.
30 sekunder för att komma igång med tre exempel
Nedan tre kodavsnitt gör samma sak: de anropargpt-4o-mini och ber den att endast svara med ADC_*_OK. Varje avsnitt har en verklig körningsresultat bifogad, som du kan använda med din egen token för att återskapa.
TypeScript
SDK deklarerar för närvarande svaret somProgramresultat:Record<string, unknown>, vid körning är det ett vanligt JSON-objekt som kan nås direkt via fält. I strikt TS-projekt kan du tillfälligt användaas anyom du stöter på typfel, eller referera till SDK uppgiftspolling och strömmande svar för att anpassa en typad wrapper.
Python
Python SDK returnerar för närvarande enProgramresultat:dict, så användres["id"]istället förres.id. Detta skiljer sig frånopenai-python, så var uppmärksam vid migrering.
Go
Go SDK:s svar är alltidProgramresultat:map[string]any, det finns ingen stark typstruktur, så typassertion måste göras. Alla resursåtkomstmetoder är kedjor:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, usage från samma källa: genom PlatformGateway autentisering → mål OpenAI kompatibel API → skriv in faktureringspost. Fältet content är modellens verkliga utdata, att använda den fasta identifieraren ADC_*_OK är för att bevisa att svaret inte har manipulerats av SDK.
Rekommenderad läsordning
- TypeScript SDK anslutningsguide —— kod som kan köras efter
npm install. - Python SDK anslutningsguide —— tre sätt att använda synkront, asynkront och strömmande.
- Go SDK anslutningsguide —— Go-stilens
context.Contextoch kanalströmning. - SDK uppgiftspolling och strömmande svar —— Skillnader i TaskHandle-enheter, SSE-implementeringsdetaljer, återförsök och backoff.
- SDK + X402 betalningshook —— Ingen token, avräkning baserat på anrop.
Hur man ser kvarvarande kvot
Genom Ace Data Cloud-konsolen - Applista kan du se den aktuella kontots kvarvarande kvot. Genom Ace Data Cloud-konsolen - Användningshistorik kan du se all användningshistorik och avgiftsdetaljer.Lär dig mer
- 📦 SDK monorepo källkod
- 🔌 X402 integrationsguide
- 🛠 MCP Servers guide
- 📊 Tjänstelista och prissättning

