---
title: 빠른 시작
slug: api-guide/ko
docTags: 
createdAt: 2024-12-06T10:02:59.000Z
---

Kognic은 Python으로 API를 손쉽게 호출할 수 있도록 [kognic-io](https://pypi.org/project/kognic-io/)라는 클라이언트를 제공합니다.

## 설치

pip를 통해 설치하세요.

::::Tabs
:::Tab{title="kognic-io"}
파일 업로드나 프로젝트 관리와 같은 가장 일반적인 사용 사례를 위해 `kognic-io`를 설치하세요.

```bash
pip install --upgrade kognic-io
```
:::

:::Tab{title="kognic-auth"}
파일 업로드에는 필요하지 않습니다. 데이터셋 탐색 또는 어노테이션 통합 기능을 사용하려는 경우 `kognic-auth`를 설치하세요.

```bash
pip install --upgrade kognic-auth
```
:::
::::

## 자격 증명 생성하기

메인 플랫폼에서는 사용자 메뉴의 여기를 클릭하여 자격 증명을 생성할 수 있습니다.

::Image[]{src="https://api.archbee.com/api/optimize/wLEz_RbWP6nIMpY-prjlm/G6e0fG28Y_oKoaAHuu_A__creds-en.png" size="60" isUploading="false" position="center" width="470" height="298" darkWidth="470" darkHeight="298" showCaption="false"}

## 자격 증명 설정하기

환경 변수 `KOGNIC_CREDENTIALS`를 자격 증명 파일을 가리키도록 설정하세요.

```bash
export KOGNIC_CREDENTIALS=~/path/to/credentials.json
```

## 자격 증명 확인하기

자격 증명이 올바른지 확인하려면 Python에서 간단히 프로젝트 목록을 조회하면 됩니다.

:::hint{type="info"}
kognic-io v2.4.0부터 쓰기 작업에 사용할 워크스페이스 id를 제공할 수 있습니다.
여러 워크스페이스를 사용하는 사용자의 경우 이는 필수입니다. [고급 설정](docId\:PN7g44HOAl8gvbqpgAgqF)
:::

::::Tabs
:::Tab{title="kognic-io"}
```python
from kognic.io.client import KognicIOClient

client = KognicIOClient()
client.project.get_projects()
print("success")
```

이제 Kognic 플랫폼과 상호 작용할 준비가 되었습니다.
:::
::::

## 다음 단계

- [첫 번째 씬 업로드하기](docId\:NyVbHeKD-LyiGEFWp-inx): Kognic 플랫폼에 데이터를 업로드하는 방법에 대한 간단한 안내