Skip to main content
Ace Data Cloud oferuje oficjalne klienty SDK w trzech językach: TypeScript / Python / Go, które opakowują możliwości takie jak chat completions, images, video, music, search, x402 dostępne na 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

Macierz możliwości w trzech językach

Zasoby multimedialne SDK Go oraz cykle zadań są obecnie w fazie alpha (wersja pseudo v0.0.0-20260505072132-4a3d921f9bb4), stabilną możliwością jest chat.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ć:
Można również jawnie przekazać ją podczas tworzenia klienta, odpowiednie nazwy parametrów dla trzech języków to:
  • 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ą tylko ACEDATACLOUD_API_TOKEN. Jeśli w twoim środowisku jest tylko ACEDATACLOUD_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ź jako 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.
Wynik działania programu:

Python

Python SDK obecnie zwraca dict, więc używaj res["id"] zamiast res.id. To różni się od openai-python, na co należy zwrócić uwagę podczas migracji.
Wynik działania programu:

Go

Odpowiedzi SDK Go są jednolite jako 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(...).
Wynik działania programu:
W odpowiedziach trzech języków 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

  1. Przewodnik po integracji SDK TypeScript — kod, który można uruchomić po npm install.
  2. Przewodnik po integracji SDK Python — trzy zestawy zastosowań: synchroniczne, asynchroniczne, strumieniowe.
  3. Przewodnik po integracji SDK Go — styl Go z context.Context i strumieniami kanałów.
  4. Polling zadań SDK i odpowiedzi strumieniowe — różnice jednostkowe TaskHandle, szczegóły implementacji SSE, strategia ponownego próbowania.
  5. 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