Skip to main content
**계정 토큰(Account Token, 구 명칭 Platform Token)**은 개발자가 프로그래밍 방식으로 AceDataCloud 플랫폼 리소스(서비스 신청, API 자격 증명, 주문, 호출 기록, 잔액, 파일 등)를 관리하는 “계정 수준 키”입니다. 그 역할은 프런트엔드 로그인 후의 사용자 Token과 유사하며, 기본적으로 만료 시간이 없습니다. 일반 사용자는 자신의 토큰만 관리할 수 있고, 슈퍼 관리자는 권한에 따라 다른 계정의 토큰을 관리할 수 있습니다. 계정 토큰은 소속 계정의 현재 권한으로 플랫폼 인터페이스에 접근합니다. 기본 권한, 직접 부여된 권한 및 소속 사용자 그룹 권한이 병합되어 적용되며, 그룹 가입 또는 탈퇴 후 다음 요청부터 새 권한에 따라 판단됩니다. 구체적인 신청, 주문 등의 리소스 접근은 여전히 소유권 검증을 통과해야 합니다. 계정 토큰은 기본적으로 만료되지 않으므로, 신뢰할 수 있는 환경에서만 사용하고 안전하게 보관하세요.
ℹ️ 이 인터페이스는 AceDataCloud 플랫폼 관리 API에 속하며, 공통 접두사는 https://platform.acedata.cloud/api/v1/입니다. 전체 인터페이스 색인은 AceDataCloud 플랫폼 문서 목록 가져오기를 참조하세요.

계정 토큰 vs API 자격 증명

초보자가 가장 쉽게 혼동하는 두 종류의 키이므로, 먼저 명확히 확인하세요. 단지 GPT-4.1을 호출하려는 경우 필요한 것은 API 자격 증명이며, 계정 토큰이 아닙니다. 자동화 스크립트를 작성하여 충전을 관리하고, 매월 청구서를 확인하며, 팀원에게 자격 증명을 일괄 발급하려는 경우에만 계정 토큰을 사용합니다.

콘솔에서 원클릭 생성(권장)

  1. https://platform.acedata.cloud에 로그인합니다.
  2. 사이드바 → 「개발자」→ 「Account Token」으로 이동합니다.
  3. 우측 상단의 「생성」 버튼을 클릭하면 즉시 platform-v1-... 토큰 하나를 얻습니다. 복사 버튼을 눌러 비밀번호 관리기에 저장하세요.
Account Token 콘솔
⚠️ 현재 생성, 목록 및 상세 응답은 모두 토큰 평문을 반환합니다. 전체 응답을 비밀 정보로 처리하고 로그, 분석 플랫폼 또는 프런트엔드 영구 저장소에 기록하지 마세요. 클라이언트 역시 목록이 장기간 평문을 반환하는 것에 의존해서는 안 됩니다.

API로 계정 토큰 생성

인터페이스 개요

인증 설명(닭이 먼저냐 달걀이 먼저냐 문제)

첫 번째 토큰은 어떻게 얻나요? 답은 콘솔을 이용하는 것입니다. 브라우저 로그인 후 콘솔은 JWT 인증을 사용하여 POST /platform-tokens/를 호출하고, 첫 번째 토큰을 발급합니다. 이후에는 기존의 platform-v1-... 토큰 중 아무 것이나 사용하여 더 많은 토큰을 생성할 수 있습니다.
요청 헤더 형식:

요청 예시

응답(HTTP 201)

필드 설명


계정 토큰 목록 가져오기

인터페이스 개요

필수 쿼리 매개변수

⚠️ 반드시 ?user_id=<your_user_id>를 포함해야 합니다. 이유: 목록 인터페이스는 페이지네이션 결과에 대해 객체별로 권한 검사를 수행하며, user_id를 포함하지 않으면 본인 소유가 아닌 첫 번째 객체에서 거부되어 403 permission_denied를 반환합니다.
user_id를 가져오는 방법:
  1. 브라우저에서 https://auth.acedata.cloud/user/profile을 열면 페이지 상단에 전체 UUID가 표시됩니다.
  2. 또는 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을 받고, 그 반대도 마찬가지입니다.

관련 인터페이스