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, сначала получите API Token в консоли Ace Data Cloud - Список приложений:
Если вы еще не вошли в систему или не зарегистрированы, вас автоматически перенаправят на страницу входа, чтобы пригласить вас зарегистрироваться и войти. После входа или регистрации вы будете автоматически возвращены на текущую страницу.
При первом запросе будет предоставлен бесплатный лимит, чтобы вы могли бесплатно опробовать различные AI-сервисы, предлагаемые Ace Data Cloud.
Скопируйте только что полученный токен, далее будем обозначать его как {token}.
Унифицированные переменные окружения
SDK на трех языках автоматически считывает одну и ту же переменную окруженияACEDATACLOUD_API_TOKEN, рекомендуется использовать export в shell, чтобы 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, нет строгих типов struct, требуется самостоятельно выполнять приведение типов. Все ресурсы доступны через цепочку методов:client.OpenAI().Chat().Completions().Create(...).
id, elapsed_ms, usage происходят из одного источника: через PlatformGateway аутентификация → целевой OpenAI совместимый API → запись в учетные записи. Поле content является реальным выводом модели, использование фиксированного идентификатора ADC_*_OK предназначено для подтверждения, что ответ не был изменен SDK.
Рекомендуемый порядок чтения
- Руководство по интеграции SDK TypeScript — код, который можно запустить после
npm install. - Руководство по интеграции SDK Python — три набора методов: синхронный, асинхронный, потоковый.
- Руководство по интеграции SDK Go — стиль Go с
context.Contextи потоками канала. - SDK опрос задач и потоковые ответы — различия в единицах TaskHandle, детали реализации SSE, повторные попытки с экспоненциальной задержкой.
- SDK + X402 платежные хуки — без токена, расчет по вызову на блокчейне.
Как проверить оставшийся лимит
Через консоль Ace Data Cloud - Список приложений можно просмотреть текущий остаток на счете. Через консоль Ace Data Cloud - История использования можно просмотреть всю историю использования и детали списания.Узнать больше
- 📦 Исходный код SDK monorepo
- 🔌 Руководство по интеграции X402
- 🛠 Учебник по серверам MCP
- 📊 Список услуг и цены

