API 키 생성하기 | Venice API 문서

Venice API 요청은 Bearer API 키로 인증됩니다. 이 가이드에서는 Venice 대시보드에서 키를 생성하고, 안전하게 보관하며, 정상 작동 여부를 확인하는 방법을 설명합니다.

지갑으로 자체 키를 발급해야 하는 자율 에이전트를 구축하는 경우에는 자율 에이전트 API 키 생성 가이드를 대신 사용하십시오.

시작하기 전에

Venice 계정에 로그인합니다.
유료 엔드포인트를 호출하기 전에 계정에 사용 가능한 잔액이 있는지 확인하십시오. 계정에 자금을 충전하기 전에도 키를 생성할 수 있지만, 계정이 DIEM, 번들 크레딧 또는 USD를 사용할 수 있을 때까지 모델 요청은 성공하지 않습니다.

API 설정 열기

https://venice.ai/settings/api을 방문합니다. Venice 앱의 설정에서 API를 선택하여 이 페이지를 열 수도 있습니다.API 설정 대시보드에는 잔액, API 등급, 사용량 및 기존 API 키가 표시됩니다.

새 키 시작하기

Generate New API Key를 선택한 다음, 키를 구성합니다:

Description: 이 키를 사용할 앱, 환경 또는 통합을 식별할 수 있는 짧은 이름을 사용하십시오.
API Key Type: 일반적인 모델 요청에는 Inference Only를 사용합니다. 키가 프로그래밍 방식으로 API 키를 관리해야 하는 경우에만 Admin을 사용하십시오.
Expires at: 선택적으로 만료 날짜를 설정합니다. 비워두면 키는 자동으로 만료되지 않습니다.
Epoch Consumption Limits: 선택적으로 이 키가 24시간 epoch 동안 사용할 수 있는 DIEM 또는 USD 금액을 제한합니다. 비워두면 키는 계정 한도 내에서 계정의 사용 가능한 잔액을 사용할 수 있습니다.

키 생성 및 복사

Generate를 클릭합니다. Venice는 전체 API 키를 한 번만 표시합니다.

키를 즉시 복사하여 안전한 위치에 보관하십시오. 대화상자를 닫은 후에는 Venice가 키 설명과 마지막 문자와 같은 식별용 메타데이터만 표시합니다. 비밀 값을 분실한 경우 해당 키를 삭제하고 새로 생성하십시오.

키를 로컬 환경 또는 시크릿 매니저에 추가합니다:

export VENICE_API_KEY="your-api-key-here"

키 확인하기

인증이 정상적으로 작동하는지 확인하기 위해 위험이 낮은 요청을 보냅니다:

curl --request GET \
  --url https://api.venice.ai/api/v1/models \
  --header "Authorization: Bearer $VENICE_API_KEY"

성공적인 응답은 사용 가능한 모델 목록을 반환합니다. 인증 오류가 발생하면 키가 완전히 복사되었는지, Authorization 헤더가 Bearer <api-key> 형식으로 지정되었는지 확인하십시오.

Admin 키는 API 레퍼런스 엔드포인트를 통해 API 키를 관리할 수 있습니다:

기존 admin 키에서 새 대시보드 형식의 API 키를 생성합니다.

활성 키와 해당 메타데이터를 확인합니다.

키 설명, 만료 날짜 또는 소비 한도를 업데이트합니다.

더 이상 필요하지 않은 키를 폐기합니다.