프로그래밍 방식의 API Key 관리
액세스 토큰으로 API Key를 조회, 생성, 수정 및 삭제합니다.
앱에서 Key 관리를 자동화하려면 이 가이드를 따르세요. 모델 호출이나 SDK 설정만 필요하면 API Key 및 인증을 참조하세요.
액세스 토큰 받기
프로필의 ‘보안’에서 액세스 토큰을 생성하여 해당 사용자의 Key를 관리합니다.
액세스 토큰과 모델 API Key는 용도가 다릅니다. 관리 API는 액세스 토큰, 모델 API는 API Key를 사용하므로 혼용하지 마세요.
첫 관리 요청 보내기
your-user-token을 액세스 토큰으로 바꾸고 Key 목록을 조회하세요:
curl 'https://api.agtcloud.cn/api/token/?p=1&size=20' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-user-token'성공 후 data.items에서 Key를 찾아 id를 저장하고 상세 조회·수정·삭제에 사용하세요. 기록이 없으면 items는 빈 배열입니다.
목록/상세의 key는 마스킹되어 모델 호출에 사용할 수 없을 수 있습니다. 전체 비밀 키는 API Keys 페이지에서 확인하세요.
관리 작업 선택
해당 Reference에서 매개변수, 응답 예제를 확인하거나 온라인 테스트를 사용하세요.
| 작업 | 용도 |
|---|---|
| API Key 목록 조회 | Key 목록을 페이지별로 보기 |
| API Key 검색 | 이름이나 키 값으로 검색 |
| 단일 API Key 조회 | ID로 상세 설정 읽기 |
| API Key 생성 | 이름·할당량·만료·접근 제한 설정 |
| API Key 수정 | 설정 변경 또는 활성/비활성 전환 |
| API Key 삭제 | 지정 Key 삭제 |
| API Key 일괄 삭제 | 여러 Key 삭제 |
Key 자체의 잔여 할당량은 API Key 할당량 조회를 사용하세요. 액세스 토큰이 아닌 해당 Key로 인증합니다.
작업 주의사항
수정·삭제 전 대상 확인
일반 수정은 생략 필드를 초기화할 수 있습니다. 상세를 읽은 뒤 유지할 설정을 모두 보내세요. 활성/비활성만 바꾸려면 ‘상태만 수정’을 사용합니다.
삭제는 해당 Key를 쓰는 앱에 영향을 줍니다. 대상 ID를 확인하고 예제 ID로 삭제하지 마세요.
- 업무 결과 확인: HTTP
200에도 업무 실패가 있을 수 있으므로success,message를 확인하세요. - 중복 쓰기 방지: 생성·수정·삭제가 시간 초과되면 먼저 조회하여 반영 여부를 확인하고 즉시 재전송하지 마세요.
- 액세스 토큰 보호: 통제된 서버에 저장하고 프런트엔드, 공개 로그, 스크린샷, 저장소에 포함하지 마세요. 키 값이 있는 검색 URL도 보호하세요.