ℹ️ Цей інтерфейс належить до API керування платформою AceDataCloud, з єдиним префіксом https://platform.acedata.cloud/api/v1/. Повний індекс інтерфейсів див. у Отримання списку документації платформи AceDataCloud.
Токен облікового запису vs API-облікові дані
Два типи ключів, які новачки найчастіше плутають, спершу чітко розберіться:
Якщо ви лише хочете викликати GPT-4.1, вам потрібні API-облікові дані, а не токен облікового запису.
Якщо ви хочете написати автоматизований скрипт для керування поповненнями, перегляду щомісячних рахунків або масового надсилання облікових даних членам команди, тоді використовуйте токен облікового запису.
Створення в консолі одним кліком (рекомендовано)
- Увійдіть до https://platform.acedata.cloud.
- Перейдіть у бічному меню → «Розробник» → «Account Token».
- Натисніть кнопку «Створити» у верхньому правому куті, і одразу отримаєте токен
platform-v1-...; натисніть кнопку копіювання та збережіть його в менеджері паролів.
⚠️ Поточні відповіді на створення, список і деталі повертають токен у відкритому вигляді. Обробляйте всю відповідь як секрет: не записуйте її в журнали, аналітичні платформи або постійне сховище фронтенду; клієнт також не повинен покладатися на те, що список тривалий час повертатиме токен у відкритому вигляді.
Створення токена облікового запису через API
Огляд інтерфейсу
Пояснення авторизації (проблема курки та яйця)
Як отримати перший токен? Відповідь — через консоль: після входу в браузері консоль використовує JWT-авторизацію для викликуФормат заголовків запиту:POST /platform-tokens/і видає вам перший токен. Після цього ви можете використовувати будь-який наявний токен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 — переглянути історію поповнень

