메인 콘텐츠로 건너뛰기
Admin 키는 API를 통해 다른 모든 API 키를 관리할 수 있습니다. 각 앱, 환경 또는 고객에게 전용 Inference 키를 발급하고, 키별 지출 한도를 제한하고, 키별 사용량을 추적하며, 대시보드를 열지 않고도 키를 변경하거나 폐기할 수 있습니다.

생성

지출 상한이 있는 키 발급

추적

각 키의 지출 확인

변경

상한 상향 또는 만료 연장

폐기

키를 즉시 차단

작동 방식

Admin 키제어용 키키 생성, 변경 및 폐기사용량 및 청구 정보 조회서버에만 보관
Inferencecust:acme$50 / 월프라이빗 모델만
Inferencecust:globex$5 / 월11.22.33.0/24에서만
Inferencestaging$10 / 일6월 30일 만료
Admin 키는 키를 관리하고 청구 정보를 조회하는 엔드포인트를 포함하여 모든 엔드포인트를 호출할 수 있습니다. Inference 키는 모델을 호출할 수 있지만 키를 관리하거나 청구 정보를 조회할 수는 없으므로, 외부에 나누어 주는 키는 Inference 키입니다.
첫 번째 Admin 키는 대시보드에서 생성하십시오. API 키 생성하기를 따라 키 유형으로 Admin을 선택합니다. 이 키는 클라이언트 코드가 아닌 서버 측 시크릿 저장소에 보관하십시오.
이 페이지의 예제는 VENICE_ADMIN_KEY에서 Admin 키를 읽습니다:

키 생성하기

다음은 한 고객을 위한 Inference 키를 생성하는 예제로, 월 $50의 상한이 있으며 2027년 6월 30일에 만료됩니다:
Response
data.apiKey는 키의 비밀 값이며, 이 응답에서만 확인할 수 있습니다. 즉시 저장하십시오. 분실한 경우 해당 키를 폐기하고 새로 생성하십시오. data.id도 보관하십시오. 이 페이지의 다른 모든 호출에서 사용됩니다.

키 설정

키를 생성할 때 이 값들을 설정하거나, 나중에 PATCH /api_keys로 변경할 수 있습니다. 요청 본문은 엄격하게 검증되므로 알 수 없는 필드가 있으면 400이 반환됩니다. 분당 최대 20개의 키를 생성할 수 있으며, 활성 키는 최대 500개까지 유지할 수 있습니다. 더 필요한 경우 지원팀에 문의하십시오.
에이전트를 구축하고 계신가요? Base에서 스테이킹된 VVV를 보유한 지갑은 Venice 계정 없이도 자체 키를 발급할 수 있습니다. 자율 에이전트 API 키 생성을 참조하십시오.

사용량 추적하기

단일 키

Response (trimmed)
이 키는 이번 달 $50 중 $12.50를 사용했습니다. 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
Admin 키로 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 키가 포함된 모든 요금 내역.