api.acedata.cloud у типізовані методи, що дозволяє уникнути ручного написання HTTP, SSE, опитування завдань, обробки помилок та повторних спроб.
Цей розділ організовано за реальним порядком підключення: спочатку отримайте API Token у консолі, потім виберіть мову та перегляньте відповідний розділ, а в кінці ознайомтеся з розширеними можливостями опитування завдань, потокових відповідей та X402 оплати на блокчейні.
Репозиторій та пакети
- Код SDK (monorepo): https://github.com/AceDataCloud/SDK
- TypeScript:
@acedatacloud/sdk - Python:
acedatacloud - Go:
github.com/AceDataCloud/SDK/go - X402 клієнт (TypeScript):
@acedatacloud/x402-client - X402 клієнт (Python):
acedatacloud-x402
Матриця можливостей трьох мов
Мультимедійні ресурси та опитування завдань Go SDK наразі знаходяться на стадії alpha (псевдоверсіяv0.0.0-20260505072132-4a3d921f9bb4), стабільною можливістю єchat.completions. Для мультимедійних сценаріїв рекомендується обирати TypeScript або Python.
Коли використовувати SDK / MCP / рідний HTTP / X402
SDK та X402 не є взаємовиключними: SDK підтримує як «шлях токена», так і «шлях
paymentHandler», деталі див. SDK + X402 платіжний хук.
Як отримати API Token
Щоб використовувати SDK, спочатку перейдіть до консолі Ace Data Cloud - Список додатків та отримайте API Token:
Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку.
При першому запиті вам буде надано безкоштовний ліміт, щоб ви могли безкоштовно випробувати різні AI послуги, які надає Ace Data Cloud.
Скопіюйте отриманий токен, далі будемо позначати його як {token}.
Уніфіковані змінні середовища
SDK трьох мов автоматично зчитує одну й ту ж змінну середовищаACEDATACLOUD_API_TOKEN, рекомендується в shell виконати export, щоб SDK автоматично її підхопив:
- TypeScript:
new AceDataCloud({ apiToken: '{token}' }) - Python:
AceDataCloud(api_token="{token}") - Go:
adc.NewClient(adc.WithAPIToken("{token}"))
Зверніть увагу: у репозиторії проекту AceDataCloud зазвичай використовуєтьсяACEDATACLOUD_API_KEY(в.env/ CI), але ці три SDK розпізнають лишеACEDATACLOUD_API_TOKEN. Якщо у вашому середовищі є лишеACEDATACLOUD_API_KEY, будь ласка, передайте його явно під час створення.
30 секунд для ознайомлення з трьома прикладами
Нижче наведені три фрагменти коду виконують одну й ту ж задачу: викликаютьgpt-4o-mini, щоб він відповів лише ADC_*_OK. Кожен фрагмент супроводжується реальними результатами виконання, ви можете відтворити їх, використовуючи свій токен.
TypeScript
SDK наразі оголошує відповідь якРезультати виконання програми:Record<string, unknown>, під час виконання це звичайний JSON об’єкт, до якого можна звертатися за полями. У строгих проектах TS, якщо виникають помилки типу, можна тимчасово використовуватиas any, або звернутися до SDK опитування завдань та потокових відповідей для створення типізованого обгортання.
Python
Python SDK наразі повертаєРезультат виконання програми:dict, тому використовуйтеres["id"], а неres.id. Це відрізняється відopenai-python, на це потрібно звернути увагу під час міграції.
Go
Go SDK відповіді завжди єРезультат виконання програми:map[string]any, немає сильно типізованих структур, потрібно самостійно виконувати приведення типів. Всі ресурси доступні через ланцюг методів:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, usage походять з одного джерела: через PlatformGateway аутентифікація → цільовий OpenAI сумісний API → запис у платіжні записи. Поле content є справжнім виходом моделі, використання фіксованого ідентифікатора ADC_*_OK є для підтвердження, що відповідь не була змінена SDK.
Рекомендований порядок читання
- TypeScript SDK інтеграційний посібник — код, який можна запустити після
npm install. - Python SDK інтеграційний посібник — три набори використання: синхронне, асинхронне, потокове.
- Go SDK інтеграційний посібник — стиль Go з
context.Contextта потоками каналу. - SDK опитування завдань та потокові відповіді — різниця в одиницях TaskHandle, деталі реалізації SSE, повторні спроби з затримкою.
- SDK + X402 платіжні гачки — без токена, розрахунок за викликами на ланцюзі.
Як перевірити залишок
Через консоль Ace Data Cloud - Список додатків можна перевірити залишок на рахунку. Через консоль Ace Data Cloud - Історія використання можна переглянути всю історію використання та деталі витрат.Дізнатися більше
- 📦 SDK monorepo вихідний код
- 🔌 Посібник з інтеграції X402
- 🛠 Посібник з MCP Servers
- 📊 Список послуг та ціни

