Skip to main content
Ace Data Cloud erbjuder officiella klient-SDK:er för TypeScript / Python / Go, som kapslar in funktioner som chat completions, images, video, music, search, x402 etc. från 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

Tre språk kapabilitetsmatris

Go SDK:s multimediaresurser och uppgiftspolling är för närvarande i alpha-stadiet (pseudo-version v0.0.0-20260505072132-4a3d921f9bb4), den stabila kapabiliteten är chat.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övariabel ACEDATACLOUD_API_TOKEN, det rekommenderas att export i shell så att SDK automatiskt plockar upp den:
Det går också att explicit ange den vid konstruktion av klienten, de motsvarande parameter namnen för de tre språken är:
  • 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ända ACEDATACLOUD_API_KEY (i .env / CI), men dessa tre SDK:er känner endast igen ACEDATACLOUD_API_TOKEN. Om din miljö endast har ACEDATACLOUD_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 anropar gpt-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 som 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ända as any om du stöter på typfel, eller referera till SDK uppgiftspolling och strömmande svar för att anpassa en typad wrapper.
Programresultat:

Python

Python SDK returnerar för närvarande en dict, så använd res["id"] istället för res.id. Detta skiljer sig från openai-python, så var uppmärksam vid migrering.
Programresultat:

Go

Go SDK:s svar är alltid map[string]any, det finns ingen stark typstruktur, så typassertion måste göras. Alla resursåtkomstmetoder är kedjor: client.OpenAI().Chat().Completions().Create(...).
Programresultat:
I svaren från de tre språken kommer 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

  1. TypeScript SDK anslutningsguide —— kod som kan köras efter npm install.
  2. Python SDK anslutningsguide —— tre sätt att använda synkront, asynkront och strömmande.
  3. Go SDK anslutningsguide —— Go-stilens context.Context och kanalströmning.
  4. SDK uppgiftspolling och strömmande svar —— Skillnader i TaskHandle-enheter, SSE-implementeringsdetaljer, återförsök och backoff.
  5. 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