Management API Keys

Management API Key는 팀 전체의 프로젝트, 예산 및 모델 API 키를 관리하고 프로젝트와 키 사용량을 조회합니다.

Management API Key는 팀 전체의 프로젝트, 예산 및 모델 API 키를 관리하고 프로젝트와 키 사용량을 조회합니다.

엔드포인트별 키 유형

이 표는 API 키를 비교합니다. 활성화된 OAuth scoped token을 통한 결제 조회는 기존 방식으로 지원됩니다.

관리 키 생성

  1. Console에 로그인하고 본인이 Owner인 팀 계정으로 전환합니다.
  2. 사이드바의 Developer → Management API Keys를 열거나 관리 페이지로 바로 이동합니다. 이 메뉴는 현재 팀 Owner에게만 표시됩니다.
  3. Name을 입력하고 필요하면 **Expires (optional)**을 설정한 뒤 Create key를 클릭합니다.
  4. Copy key를 클릭해 새 mgmt-... 키를 저장하고 아래 예제의 ATLASCLOUD_MANAGEMENT_API_KEY로 사용합니다. 비밀 키는 한 번만 표시됩니다.

api_key_id는 어디서 얻나요?

URL의 api_key_id는 모델 API 키 생성(POST /public/v1/api-keys) 응답의 id이며, 형식은 ak_...입니다. 비활성화, 삭제, 한도 설정, 사용량 조회에 필요하므로 저장하세요. 응답의 key(apikey-...)는 모델 호출용이며, 관리 호출의 인증 헤더에는 계속 mgmt-...를 사용합니다.

예를 들어 생성 응답에는 다음 필드가 포함됩니다.

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

같은 id를 /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage처럼 경로에 넣습니다. 예제의 API_KEY_ID도 이 값을 뜻합니다. 현재 Public API에는 키 목록 조회가 없으므로 생성 시 id를 저장하세요.

Public API 호출

관리 키를 Authorization: Bearer 헤더에 넣으세요. 요청에는 해당 키에 연결된 Team 계정이 사용됩니다.

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

단계별 생성 가이드(영어).

키 관리

비활성화, 삭제 또는 만료된 관리 키로는 인증할 수 없습니다. 관리 페이지에서 만료되지 않은 키를 활성화하거나 비활성화할 수 있습니다. 삭제는 취소할 수 없습니다.

관리 키는 팀에 속하며 생성자가 팀을 떠나거나 Owner가 아니게 되어도 유효합니다. 현재 Owner는 이전 Owner가 생성한 키도 관리할 수 있습니다. 접근을 취소하려면 키를 비활성화하거나 삭제하세요.

팀마다 비활성화 및 만료된 키를 포함해 삭제되지 않은 관리 키를 최대 5개까지 보유할 수 있습니다. 키를 삭제하면 자리가 확보됩니다.

Last updated on

On this page