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, сначала получите 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.

Рекомендуемый порядок чтения

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

Как проверить оставшийся лимит

Через консоль Ace Data Cloud - Список приложений можно просмотреть текущий остаток на счете. Через консоль Ace Data Cloud - История использования можно просмотреть всю историю использования и детали списания.

Узнать больше