ℹ️ 이 인터페이스는 AceDataCloud 플랫폼 관리 API에 속하며, 공통 접두사는 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가 표시됩니다.
- 또는
POST /platform-tokens/반환값의user_id필드를 직접 다시 입력합니다.
쿼리 매개변수
요청 예시
응답(HTTP 200)
이 인터페이스의 페이지네이션 응답은count+items를 사용합니다. 다른 플랫폼 인터페이스는 다른 구조를 사용할 수 있으므로, 해당 문서와 실제 응답을 기준으로 하십시오.
계정 토큰 세부 정보 가져오기
HTTP 200입니다.
계정 토큰 삭제
- 성공 시
HTTP 204 No Content를 반환하며, 응답 본문은 없습니다. - 삭제 후 해당 토큰은 즉시 무효화되며, 이를 사용 중인 모든 서비스는 즉시
401을 받습니다. - 해당
id를 다시 조회하면404를 반환합니다.
⚠️ 삭제는 되돌릴 수 없습니다. 토큰 유출이 의심되는 경우 먼저 새 토큰을 생성하고, 비즈니스 측을 전환한 후, 이전 토큰을 삭제할 수 있습니다.
지원되지 않는 작업
오류 코드 빠른 참조
오류 응답의 통합 형식:
trace_id를 고객 지원팀에 제공하거나 티켓에 첨부하면 로그를 빠르게 찾을 수 있습니다.
전체 코드 예시
Python
Node.js
다른 플랫폼 API에서 사용
platform-v1-...를 Authorization: Bearer ... 헤더에 직접 넣으면 인증이 필요한 모든 플랫폼 인터페이스를 호출할 수 있습니다:
https://api.acedata.cloud/**비즈니스 인터페이스(OpenAI, Midjourney, Suno, Veo 등)에서 사용하는 32자리 16진수 API 자격 증명과는 완전히 다릅니다. 혼용하지 마십시오——계정 토큰을 비즈니스 인터페이스에 입력하면401을 받고, 그 반대도 마찬가지입니다.
관련 인터페이스
- AceDataCloud 플랫폼 서비스 신청 목록 가져오기 — 계정 토큰으로 자신이 신청한 서비스를 확인합니다
- AceDataCloud 플랫폼 API 자격 증명 생성하기 — 계정 토큰으로 비즈니스 API용 32자리 자격 증명을 발급합니다
- AceDataCloud 플랫폼 API 호출 기록 가져오기 — 청구 내역 조회 및 오류 해결
- AceDataCloud 플랫폼 주문 목록 가져오기 — 충전 이력을 조회합니다

