Skip to main content
Ace Data Cloud надає офіційні клієнтські SDK для трьох мов: TypeScript / Python / Go, які інкапсулюють можливості chat completions, images, video, music, search, x402 тощо на api.acedata.cloud у типізовані методи, що дозволяє уникнути ручного написання HTTP, SSE, опитування завдань, обробки помилок та повторних спроб. Цей розділ організовано за реальним порядком підключення: спочатку отримайте API Token у консолі, потім виберіть мову та перегляньте відповідний розділ, а в кінці ознайомтеся з розширеними можливостями опитування завдань, потокових відповідей та 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.

Рекомендований порядок читання

  1. TypeScript SDK інтеграційний посібник — код, який можна запустити після npm install.
  2. Python SDK інтеграційний посібник — три набори використання: синхронне, асинхронне, потокове.
  3. Go SDK інтеграційний посібник — стиль Go з context.Context та потоками каналу.
  4. SDK опитування завдань та потокові відповіді — різниця в одиницях TaskHandle, деталі реалізації SSE, повторні спроби з затримкою.
  5. SDK + X402 платіжні гачки — без токена, розрахунок за викликами на ланцюзі.

Як перевірити залишок

Через консоль Ace Data Cloud - Список додатків можна перевірити залишок на рахунку. Через консоль Ace Data Cloud - Історія використання можна переглянути всю історію використання та деталі витрат.

Дізнатися більше