---
title: "API 키는 어떻게 받고, API는 어떻게 호출하나요?"
description: "Settings의 Claude에서 개인 키(모든 역할)를 만들거나, API로 워크스페이스 키(프로듀서 이상)를 만들어 bearer 토큰으로 보내세요."
url: https://www.filmsquare.ai/help/ko/connect/api-keys/
lang: ko
section: connect
updated: 2026-11-13
---

앱, 내 Claude, 내 스크립트는 모두 같은 REST API를 같은 역할로 호출해요. 키는 `fsk_`로 시작하고, 워크스페이스 하나에 속하며, 대신 일하는 사람보다 많은 권한을 갖지 않아요. `Authorization: Bearer <key>`로 `https://app.filmsquare.ai/v1`에 보내세요.

## 개인 키 만들기

개인 키는 모든 역할이 쓸 수 있어요.

1. **Settings**(설정)를 열고 **Claude**를 선택해요.
2. **Use a personal key instead**(대신 개인 키 사용)를 선택해요.
3. **Name of the key**(키 이름)를 입력하고 **Create a personal key**(개인 키 만들기)를 선택해요.
4. 키를 복사해요. 한 번만 보여요.

테스트하려면 이렇게 해요.

```bash
curl -s "https://app.filmsquare.ai/v1/me" -H "Authorization: Bearer $FS_KEY"
```

개인 키는 키 관리를 제외하고 내 역할이 허용하는 일을 할 수 있어요. 중단하려면 같은 페이지에서 **Disconnect**(연결 해제)를 선택하세요.

## 워크스페이스 키 만들기

프로듀서나 소유자는 API로 에이전트 사용자를 위한 것을 포함해 역할을 정해 키를 만들 수 있어요. 역할은 내 역할보다 높을 수 없고, 호출은 로그인한 세션에서 와야 해요. 개인 키나 Claude 연결로는 키를 만들 수 없어요. 요청 방법과 목록, 폐기 경로는 문서의 [워크스페이스 API 키](https://www.filmsquare.ai/docs/ko/api/overview/#a-workspace-api-key-producer-and-up)에 있어요.

## 모든 경로 찾기

전체 레퍼런스는 `https://app.filmsquare.ai/v1/openapi.json`에 있는 공개 OpenAPI 문서 하나예요. 읽는 방법은 [OpenAPI 레퍼런스](https://www.filmsquare.ai/docs/ko/api/openapi/#reading-the-document)를, 마주칠 오류는 [API 개요](https://www.filmsquare.ai/docs/ko/api/overview/#errors-you-will-meet)를 보세요. 폴링하는 대신 테이크가 준비되면 알림을 받으려면 [테이크가 준비되면 웹훅을 받으려면 어떻게 하나요?](https://www.filmsquare.ai/help/ko/connect/webhooks/)를 보세요.
