Management API Keys
Management API Key는 팀 전체의 프로젝트, 예산 및 모델 API 키를 관리하고 프로젝트와 키 사용량을 조회합니다.
Management API Key는 팀 전체의 프로젝트, 예산 및 모델 API 키를 관리하고 프로젝트와 키 사용량을 조회합니다.
엔드포인트별 키 유형
이 표는 API 키를 비교합니다. 활성화된 OAuth scoped token을 통한 결제 조회는 기존 방식으로 지원됩니다.
관리 키 생성
- Console에 로그인하고 본인이 Owner인 팀 계정으로 전환합니다.
- 사이드바의 Developer → Management API Keys를 열거나 관리 페이지로 바로 이동합니다. 이 메뉴는 현재 팀 Owner에게만 표시됩니다.
- Name을 입력하고 필요하면 **Expires (optional)**을 설정한 뒤 Create key를 클릭합니다.
- 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