ℹ️ Этот интерфейс относится к API управления платформой AceDataCloud, единый префикс: https://platform.acedata.cloud/api/v1/. Полный индекс интерфейсов см. в Получить список документации платформы AceDataCloud.
Токен аккаунта vs API-учётные данные
Два типа ключей, которые новички чаще всего путают, сначала внимательно ознакомьтесь:
Если вы просто хотите вызвать GPT-4.1, вам нужны API-учётные данные, а не токен аккаунта.
Если вы хотите написать автоматизированный скрипт для управления пополнениями, просмотра ежемесячных счетов, массовой выдачи учётных данных членам команды — тогда используйте токен аккаунта.
Создание в консоли одним нажатием (рекомендуется)
- Войдите на https://platform.acedata.cloud.
- Перейдите в боковом меню → «Разработчик» → «Account Token».
- Нажмите кнопку «Создать» в правом верхнем углу, и сразу получите токен
platform-v1-..., нажмите кнопку копирования и сохраните его в менеджере паролей.
⚠️ Текущие ответы создания, списка и деталей возвращают токен в открытом виде. Обращайтесь со всем ответом как с секретом, не записывайте его в журналы, аналитические платформы или постоянное хранилище фронтенда; клиент также не должен полагаться на то, что список будет постоянно возвращать открытый текст.
Создание токена аккаунта через API
Обзор интерфейса
Описание аутентификации (проблема курицы и яйца)
Как получить первый токен? Ответ — через консоль: после входа в браузере консоль вызываетФормат заголовков запроса:POST /platform-tokens/с JWT-аутентификацией и выдаёт вам первый токен. После этого вы можете использовать любой существующий токенplatform-v1-...для создания новых.
Пример запроса
Ответ (HTTP 201)
Описание полей
Получение списка токенов аккаунта
Обзор интерфейса
Обязательные параметры запроса
⚠️ Необходимо передатьКак получить?user_id=<your_user_id>. Причина: интерфейс списка выполняет проверку прав для каждого объекта в результатах пагинации; еслиuser_idне передан, при первом объекте, который вам не принадлежит, запрос будет отклонён с ответом403 permission_denied.
user_id:
- Откройте в браузере https://auth.acedata.cloud/user/profile, в верхней части страницы отображается полный UUID.
- Или напрямую подставьте обратно поле
user_idиз ответаPOST /platform-tokens/.
Параметры запроса
Пример запроса
Ответ(HTTP 200)
Ответ с пагинацией этого интерфейса используетcount+items. Другие интерфейсы платформы могут использовать иную структуру, ориентируйтесь на соответствующую документацию и фактический ответ.
Получение сведений о токене учётной записи
HTTP 200.
Удаление токена учётной записи
- При успехе возвращается
HTTP 204 No Content, без тела ответа. - После удаления токен немедленно становится недействительным, все использующие его сервисы сразу получат
401. - Повторный запрос этого
idвернёт404.
⚠️ Удаление необратимо. Если вы подозреваете утечку токена, можно сначала создать новый, переключить бизнес-сторону, а затем удалить старый.
Неподдерживаемые операции
Краткая справка по кодам ошибок
Единый формат ответа об ошибке:
trace_id службе поддержки или укажите его в тикете — это позволит быстро найти логи.
Полный пример кода
Python
Node.js
Использование в других API платформы
Поместитеplatform-v1-... напрямую в заголовок Authorization: Bearer ..., чтобы вызывать любой интерфейс платформы, требующий авторизации:
Он полностью отличается от 32-значного шестнадцатеричного API-ключа, используемого бизнес-интерфейсамиhttps://api.acedata.cloud/**(OpenAI, Midjourney, Suno, Veo и т. д.). Не смешивайте их — если указать токен учётной записи в бизнес-интерфейсе, вы получите401, и наоборот.
Связанные интерфейсы
- Получение списка заявок на сервисы платформы AceDataCloud — просмотр того, на какие сервисы вы подали заявки, с помощью токена аккаунта
- Создание API-учётных данных платформы AceDataCloud — выпуск 32-значных учётных данных для бизнес-API с помощью токена аккаунта
- Получение записей вызовов API платформы AceDataCloud — проверка расчётов и устранение ошибок
- Получение списка заказов платформы AceDataCloud — просмотр истории пополнений

