생성
지출 상한이 있는 키 발급
추적
각 키의 지출 확인
변경
상한 상향 또는 만료 연장
폐기
키를 즉시 차단
작동 방식
Admin 키제어용 키키 생성, 변경 및 폐기사용량 및 청구 정보 조회서버에만 보관
Inferencecust:acme$50 / 월프라이빗 모델만
Inferencecust:globex$5 / 월11.22.33.0/24에서만
Inferencestaging$10 / 일6월 30일 만료
첫 번째 Admin 키는 대시보드에서 생성하십시오. API 키 생성하기를 따라 키 유형으로 Admin을 선택합니다. 이 키는 클라이언트 코드가 아닌 서버 측 시크릿 저장소에 보관하십시오.
VENICE_ADMIN_KEY에서 Admin 키를 읽습니다:
키 생성하기
다음은 한 고객을 위한 Inference 키를 생성하는 예제로, 월 $50의 상한이 있으며 2027년 6월 30일에 만료됩니다:Response
키 설정
키를 생성할 때 이 값들을 설정하거나, 나중에PATCH /api_keys로 변경할 수 있습니다. 요청 본문은 엄격하게 검증되므로 알 수 없는 필드가 있으면 400이 반환됩니다.
분당 최대 20개의 키를 생성할 수 있으며, 활성 키는 최대 500개까지 유지할 수 있습니다. 더 필요한 경우 지원팀에 문의하십시오.
사용량 추적하기
단일 키
Response (trimmed)
currentPeriodUsage는 USD 또는 DIEM 상한이 있는 키에만 표시되며, 사용량 금액은 소수점 이하 네 자리의 문자열입니다. 응답은 consumptionLimits(복수형)를 반환하지만, 요청에서는 consumptionLimit(단수형)을 보냅니다.
시간에 따른 키별 지출
GET /billing/usage-analytics는 byKey에 키별 합계를, byKeyDaily에 일별 한 행씩을 반환하므로 바로 차트로 만들 수 있습니다. lookback(기본값 7d, 최대 90d) 또는 최대 90일 범위의 startDate와 endDate 쌍을 전달하십시오. 결과는 10분 동안 캐시됩니다.
cURL
Response (trimmed)
키별 모든 요금 내역
GET /billing/usage-history는 모든 요금 내역을 나열하며, 각 항목에는 청구된 apiKeyId가 포함됩니다. 지출을 대사하거나 자체 고객에게 요금을 청구할 때 사용하십시오. 항목은 오래된 순으로 반환됩니다. nextCursor가 null이 될 때까지 해당 값을 단독으로 cursor로 다시 보내십시오. CSV로 받으려면 Accept: text/csv를 보내십시오.
amount는 음수이므로, 루프에서 이를 빼서 키 및 통화별 양수 합계를 구합니다. apiKeyId가 없는 항목은 Venice 웹 앱에서 발생했거나 크레딧 구매와 같은 계정 항목입니다.
키가 지금 지출할 수 있는지 여부
GET /api_keys/rate_limits는 모든 키로 호출할 수 있으며, 호출한 키에 대한 정보를 보고합니다. accessPermitted는 키가 지금 지출할 수 있는지 여부를 알려주고, balances는 남은 지출 가능 금액을 보여줍니다.
cURL
GET /api_keys/rate_limits/log를 호출하면 최근 50건의 속도 제한 발생 내역이 각각의 apiKeyId 및 modelId와 함께 반환됩니다.
한도 및 설정 변경하기
키의id와 변경하려는 필드만 보내십시오. 나머지는 그대로 유지됩니다. 다음 예제는 상한을 월 $100로 상향합니다:
새
limitPeriod는 즉시 적용되므로, LIFETIME으로 전환하면 키의 과거 지출 전체가 상한에 반영됩니다. apiKeyType은 변경할 수 없으므로 대신 새 키를 생성하십시오.
키 폐기 또는 교체하기
{ "success": true }입니다. 폐기는 즉시 적용됩니다. 해당 키의 다음 요청은 401 Authentication failed를 받으며, 키는 GET /api_keys에서 사라집니다. 과거 요금 내역은 사용 내역에 그대로 남습니다.
다운타임 없이 키를 교체하려면:
1
대체 키 생성
동일한 설정으로 새 키를 생성하고 비밀 값을 저장합니다.
2
배포
앱이 새 비밀 값을 사용하도록 전환합니다.
3
기존 키 폐기
GET /api_keys에서 기존 키의 lastUsedAt이 더 이상 변하지 않으면 해당 키를 삭제합니다.호출자에게 표시될 수 있는 오류
전체 목록은 Error Codes를 참조하십시오.
모범 사례
- Admin 키는 서버에 보관하고, 외부에는 Inference 키만 나누어 주십시오.
- 모든 앱, 환경 및 고객에게 전용 키를 발급하여 각각을 개별적으로 추적하고 폐기할 수 있도록 하십시오.
description에 자체 식별자를 입력하십시오. 사용량 분석에서 이 값으로 키를 표시합니다.- 다른 사람에게 제공하는 모든 키에는 상한과 만료를 설정하고, 서버 간 키는
ipAllowlist로 자체 IP에 고정하십시오.
API 레퍼런스
API 키 생성
생성 시 허용되는 모든 필드.
API 키 업데이트
한도, 만료, 프라이버시 및 IP 변경.
API 키 목록 조회
모든 활성 키와 사용량.
API 키 삭제
키 폐기.
사용량 분석
키, 모델 및 일별 지출.
사용 내역
API 키가 포함된 모든 요금 내역.