> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API 키 생성하기

> 대시보드에서 Venice API 키를 생성하고, bearer 토큰을 안전하게 보관한 뒤, 첫 인증된 chat completion 요청으로 정상 동작을 확인하세요.

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

<Note>
  지갑으로 자체 키를 발급해야 하는 자율 에이전트를 구축하는 경우에는 [자율 에이전트 API 키 생성](/guides/getting-started/generating-api-key-agent) 가이드를 대신 사용하십시오.
</Note>

## 시작하기 전에

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

<Steps>
  <Step title="API 설정 열기">
    [https://venice.ai/settings/api](https://venice.ai/settings/api)을 방문합니다. Venice 앱의 설정에서 **API**를 선택하여 이 페이지를 열 수도 있습니다.

    API 설정 대시보드에는 잔액, API 등급, 사용량 및 기존 API 키가 표시됩니다.
  </Step>

  <Step title="새 키 시작하기">
    **Generate New API Key**를 선택한 다음, 키를 구성합니다:

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

  <Step title="키 생성 및 복사">
    **Generate**를 클릭합니다. Venice는 전체 API 키를 한 번만 표시합니다.

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

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

    ```bash theme={null}
    export VENICE_API_KEY="your-api-key-here"
    ```
  </Step>

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

    ```bash theme={null}
    curl --request GET \
      --url https://api.venice.ai/api/v1/models \
      --header "Authorization: Bearer $VENICE_API_KEY"
    ```

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

## 모범 사례

* 개발, 스테이징, 프로덕션 환경별로 별도의 키를 생성하십시오.
* 모델 엔드포인트만 호출하는 애플리케이션에는 **Inference Only** 키를 사용하는 것이 좋습니다.
* **Admin** 키는 최소한으로 사용하고, 범위를 엄격히 제한하며, 신뢰할 수 있는 서버 측 환경에만 보관하십시오.
* API 키를 소스 컨트롤에 커밋하거나 클라이언트 측 코드에 노출하지 마십시오.
* 임시, 공유 또는 위험도가 높은 환경에서 사용되는 키에는 만료 날짜와 소비 한도를 설정하십시오.
* 사용하지 않는 키는 삭제하고, 노출되었을 가능성이 있는 키는 교체하십시오.

## 프로그래밍 방식 키 관리

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

<CardGroup cols={2}>
  <Card title="API 키 생성" icon="plus" href="/api-reference/endpoint/api_keys/create">
    기존 admin 키에서 새 대시보드 형식의 API 키를 생성합니다.
  </Card>

  <Card title="API 키 목록 조회" icon="list" href="/api-reference/endpoint/api_keys/list">
    활성 키와 해당 메타데이터를 확인합니다.
  </Card>

  <Card title="API 키 업데이트" icon="pen-to-square" href="/api-reference/endpoint/api_keys/update">
    키 설명, 만료 날짜 또는 소비 한도를 업데이트합니다.
  </Card>

  <Card title="API 키 삭제" icon="trash" href="/api-reference/endpoint/api_keys/delete">
    더 이상 필요하지 않은 키를 폐기합니다.
  </Card>
</CardGroup>