API 키 상세 조회
자신의 일반 모델 키 메타데이터 조회
중국 본토 사용자 안내: 중국 본토 사용자는 https://api.toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://api.toapis.com 을 https://api.toapis.cn 로 바꿔 주세요.
인증, 페이지 처리 및 오류는 시작하기를 참조하세요.
동작
지정 키의 메타데이터를 반환하여 이름, 상태, 할당량, 만료 시각, 모델 제한 등의 설정을 확인합니다. 소프트 삭제된 키도 읽을 수 있으며 이때 status=deleted입니다. 전체 비밀 키는 생성 및 교체 응답에서만 반환되고 본 엔드포인트는 key 필드를 반환하지 않습니다.
타인 소유이거나 존재하지 않는 키는 404를 반환합니다.
인증
Authorizationstring헤더필수Bearer YOUR_SYSTEM_ACCESS_TOKEN 을 사용합니다. 모델 API 키는 사용할 수 없습니다. X-User-Id 는 필요하지 않습니다.
요청 매개변수
api_key_idstring경로필수자신의 모델 API 키 ID 를 10 진수 문자열로 지정합니다. 타인의 키는 404 를 반환하며, 삭제된 키로도 과거 사용량을 필터링할 수 있습니다.
제약: pattern=^[1-9][0-9]*$.
요청 예제
요청 예시
curl --request GET \
--url 'https://api.toapis.com/api/v1/api-keys/42' \
--header 'Authorization: Bearer YOUR_SYSTEM_ACCESS_TOKEN'import requests
response = requests.get(
"https://api.toapis.com/api/v1/api-keys/42",
headers={"Authorization": "Bearer YOUR_SYSTEM_ACCESS_TOKEN"},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.toapis.com/api/v1/api-keys/42");
const response = await fetch(url, {
headers: { Authorization: "Bearer YOUR_SYSTEM_ACCESS_TOKEN" },
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${await response.text()}`);
}
console.log(await response.json());응답 필드
예시는 가상 데이터이며 credits_per_usd="100" 을 가정합니다. 실제 환산에는 응답 값을 사용하세요.
codeinteger결과 코드. 0 은 성공입니다.
messagestring성공 시 빈 문자열이며 오류 메시지는 현지화됩니다.
dataobject현재 조회의 결과 객체입니다.
data.idstring모델 API 키 ID 이며 비밀 키 자체가 아닙니다. 10 진수 ID 문자열로 반환합니다.
data.namestringAPI 키 이름입니다.
data.key_hintstring | null고정 마스크와 키의 마지막 4 문자입니다. 전체 키는 반환하지 않으며 짧으면 null 입니다.
data.statusstringAPI 키의 현재 상태. 자신의 소프트 삭제 키도 상세 조회할 수 있습니다. 허용 값: enabled, disabled, expired, exhausted, deleted, unknown.
data.created_atstring | null생성 시각입니다. 시간대가 포함된 RFC 3339 형식입니다. 불명확하거나 해당하지 않으면 null 입니다.
data.expires_atstring | null키 만료 시각. 만료 설정이 없으면 null 입니다. 시간대가 포함된 RFC 3339 형식입니다.
data.unlimitedboolean키가 무제한인지 나타냅니다. true 이면 remaining_credits=null 입니다.
data.remaining_creditsstring | null남은 credits. 무제한 API 키에서는 null 입니다. 정밀도를 유지하기 위해 십진수 문자열로 반환합니다.
data.daily_limit_creditsstring | null일일 credits 한도. 제한이 없으면 null 입니다. 정밀도를 유지하기 위해 십진수 문자열로 반환합니다.
data.monthly_limit_creditsstring | null월간 credits 한도. 제한이 없으면 null 입니다. 정밀도를 유지하기 위해 십진수 문자열로 반환합니다.
data.model_limitsstring[]모델 허용 목록 문자열 배열. 제한이 없으면 []이며 null은 반환하지 않습니다.
data.allow_ipsstring[]이 Key의 유효 IP 허용 목록을 사전순 문자열 배열로 반환하며 []는 제한 없음을 뜻합니다. 같은 계정의 다른 Key와 시스템 액세스 토큰에는 영향을 주지 않습니다. 일치하지 않는 출발지의 모델 호출은 403입니다. 변경은 기존 캐시 및 진행 중 요청의 동작을 따릅니다.
응답 예제
응답 예시
{
"code": 0,
"message": "",
"data": {
"id": "42",
"name": "Example Key",
"key_hint": "****abcd",
"status": "enabled",
"created_at": "2026-10-01T00:00:00Z",
"expires_at": null,
"unlimited": false,
"remaining_credits": "500",
"daily_limit_credits": "100",
"monthly_limit_credits": null,
"model_limits": [],
"allow_ips": []
}
}