> This page is for 플랫폼, version 레거시.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 실험적: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 레거시: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# 시작

<Error title="플랫폼 API 마이그레이션 필수">
  **V2 API는 더 이상 지원되지 않습니다.**새로운 기능과 개선 사항은 V4에서만 이용할 수 있습니다. [가이드 보기](/platform/v2/docs/migration/v-2-to-v-4-migration-guide).
</Error>


## Frame.io 소개

[Frame.io](https://frame.io)는 전문 비디오 팀을 위한 클라우드 협업 도구로, 창의적인 프로세스를 유지하는 데 필요한 모든 것을 단일 작업 영역에서 제공하며 어디서든 액세스할 수 있습니다. Frame.io를 사용하면 영상 프로젝트를 안전하게 업로드, 공유 및 검토할 수 있어 전체 워크플로가 창의성의 속도에 맞춰 원활하게 운영됩니다.

### Frame.io Developer Platform




모든 크리에이티브 팀, 프로세스 또는 소프트웨어 스택이 완벽히 동일할 수는 없습니다. 바로 이 부분에서 저희 Developer Platform이 진가를 발휘합니다. Frame.io Developer Platform을 사용하면 저희 API를 통해 일반적인 작업들을 처리할 수 있습니다. 개발자들이 저희 API를 사용하는 가장 인기 있는 활용 사례로는 기존 파일이나 폴더를 Frame.io 앱에 자동 추가, 새 콘텐츠 업로드, 팀 관리 등이 있습니다.





## Camera to Cloud(C2C) 프로그램

Camera to Cloud는 독특한 형태의 연동 시스템입니다. 이러한 연동은 데이터를 생성하는 모든 디바이스 또는 애플리케이션을 위해 특별히 제작되었습니다. C2C 연동 시스템을 구축하려는 경우 [C2C 연동 가이드](/device-integrations/getting-started-with-cloud-device-integrations)를 참고하시기 바랍니다. 여기에서 Frame.io를 통해 클라우드에 연결하는 데 필요한 모든 시작 정보를 찾을 수 있습니다!

## Frame.io 공식 SDK



<CardGroup cols={2}>
  
  
<Card icon="brands python" href="https://github.com/Frameio/python-frameio-client" title="Python SDK">
  
    

API 연동을 위한 Frame.io 공식 Python SDK


  
</Card>

<Card icon="terminal" href="https://github.com/Frameio/fioctl" title="Python CLI">
  
    

Frame.io 작업을 위한 명령줄 인터페이스


  
</Card>

</CardGroup>
 Frame.io는 API를 더 쉽게 시작할 수 있도록 Python 기반의 SDK를 제공하며, 여기에는 페이지 매김 및 속도 제한과 같은 핵심 개념의 추상화가 포함됩니다. 이 프로젝트는 PyPI에서 제공되므로 `pip install`만 실행하면 바로 사용할 수 있습니다! 명령줄에서 작업하는 것을 선호하신다면 PyPI에서 FIOCTL도 이용할 수 있습니다.

## 빠른 시작 안내서




지금 바로 시작하고 싶으시다면 이 버튼을 클릭하여 저희 API를 Postman으로 가져오세요!

[<img alt="Postman에서 실행" src="https://run.pstmn.io/button.svg" />](https://www.getpostman.com/collections/c2dfffb88990a9dc34c2)

그렇지 않다면 계속 읽어주세요. 시작하기 위해 먼저 로그인할 수 있는 Frame.io 계정이 있는지 확인해야 합니다.





그 후 다음을 진행합니다.



* Frame.io 자격 증명을 사용하여 [Developer Portal에 로그인](/)합니다.
* [개발자 토큰 생성](/getting-started/authentication#developer-tokens)




토큰이 올바르게 작동하는지 확인하려면 선호하는 언어, 도구, 또는 프록시를 사용하여 테스트 호출을 수행해 보세요.




<CodeBlocks>
  


**`cURL`**

```bash title="cURL"
curl --request GET \
  --url https://api.frame.io/v2/me \
  --header 'authorization: Bearer <DEV_TOKEN>'
```





**`Python`**

```python title="Python"
import requests

url = "https://api.frame.io/v2/me"
headers = {
 "Authorization": "Bearer <DEV_TOKEN>"
}

requests.GET(url,headers=headers)
```



</CodeBlocks>


응답으로 귀하의 사용자 정보를 확인할 수 있어야 합니다.





## 빌딩 블록




Frame.io와 연동되는 워크플로의 대부분은 미디어 에셋 업로드 및 검색에 중점을 둡니다. 조직 내부(또는 외부!)에 배포하기 위한 완전한 애플리케이션을 구축할 계획이라면, 배포용 OAuth 2.0 애플리케이션 구축을 고려해 볼 수도 있습니다. 다음 가이드들은 귀하의 여정을 시작하는 데 필요한 핵심 구성 요소입니다.




<CardGroup cols={3}>
  
  
<Card href="/workflows-assets/reading-the-file-tree" title="디렉터리 목록 읽기">
  
    

Frame.io의 프로젝트 구조 탐색


  
</Card>

<Card href="/workflows-assets/uploading-assets" title="에셋 업로드">
  
    

Frame.io 프로젝트에 미디어 추가


  
</Card>

<Card href="/oauth-2-applications/building-an-oauth2-app" title="OAuth 2.0 앱 구축">
  
    

여러 사용자를 위한 애플리케이션 생성


  
</Card>

</CardGroup>


모든 에셋은 프로젝트 내부에 존재합니다. 첫 번째 가이드에서는 루트 폴더에서 시작하여 프로젝트를 탐색하는 방법을 다룹니다. 특정 대상으로 이동하는 방법을 익히면 미디어 업로드를 시작하는 데 필요한 모든 준비가 끝납니다. 업로드가 정상적으로 작동하면 이제 다른 사람들이 사용할 수 있는 애플리케이션을 구축할 차례입니다!





## 이벤트 기반 워크플로




Frame.io의 Developer Platform은 워크플로를 다른 도구로 확장하거나 완전히 새로운 기능을 생성하는 데 활용할 수 있는 몇 가지 옵션을 제공합니다.





### Webhook




웹훅은 Frame.io 내부에서 발생하는 이벤트를 외부 시스템으로 전송하여 처리, API 콜백, 워크플로 자동화를 수행할 수 있는 알림으로 활용하는 방법을 제공합니다.

웹훅을 활용하는 방법에는 여러 가지가 있습니다. 직접 구축하거나 [Zapier](https://zapier.com), [Integromat](https://www.integromat.com), [Pabbly Connect](https://www.pabbly.com/) 또는 [Pipedream](https://pipedream.com)과 같은 노코드 자동화 도구를 활용할 수 있습니다.
* [웹훅](/automations-webhooks/webhooks-overview) - 웹훅은 사용 및 처리를 위해 Frame.io 이벤트를 외부 URL에 노출합니다.
* [Zapier](/zapier/get-started-with-zapier) - 코드를 작성하지 않고도 1,000개 이상의 일반적인 앱과 도구를 연결할 수 있는 온라인 자동화 도구입니다.

자체 수신기를 구축하려는 경우 시작점으로 활용할 수 있는 [웹훅 예제 앱](https://github.com/Frameio/webhooks-example-app)이 Github에 준비되어 있습니다.

### 사용자 지정 작업

[사용자 지정 작업](/custom-actions/custom-actions-overview)을 사용하면 프로그래밍 가능한 UI 구성 요소로서 Frame.io에 직접 연동 시스템을 구축할 수 있습니다. 기술적으로는 웹훅과 매우 유사하며 Frame.io 워크플로를 확장할 수 있는 훌륭한 방법입니다.

## 개발자 커뮤니티 참여

지금 당장 구축을 시작할지 확신이 서지 않는다면 [개발자 포럼](https://forum.frame.io)을 확인해 보세요. 저희 커뮤니티는 Frame.io API와 다양한 워크플로 도구를 결합하여 멋진 연동 시스템을 이미 구축했거나 현재 구축 중인 개발자, 실험적인 개발자, 크리에이티브 전문가들로 가득합니다.