← Back to Blog

Cloudflare Stream 계정을 ReedTV에 연결하는 방법 (단계별 가이드)

Updated May 3, 2026

BYOA 또는 Pro 플랜을 사용 중이라면 ReedTV는 동영상을 사용자 본인의 Cloudflare Stream 계정에 직접 업로드합니다. 이를 위해 ReedTV는 Cloudflare 대시보드에서 두 가지가 필요합니다: 올바른 Stream 권한이 있는 API Token과 Account ID입니다.

이 가이드는 두 가지를 정확히 어떻게 만드는지 안내합니다 — 어떤 권한 템플릿을 선택해야 하는지 포함해서요. 잘못된 템플릿은 연결은 성공시키지만 업로드를 조용히 망가뜨립니다. 총 소요 시간: 약 3분.

이 가이드가 존재하는 이유: 가장 흔한 BYOA 설정 문제는 읽기 전용 또는 잘못된 범위의 권한으로 만든 토큰입니다. 연결 단계는 성공하지만, 첫 번째 업로드가 인증 또는 권한 오류로 실패합니다. 아래 템플릿을 따르면 이를 완전히 피할 수 있습니다.

1부 — Cloudflare API Token 만들기

1단계. Cloudflare 프로필 열기

dash.cloudflare.com에 로그인하세요. 오른쪽 상단의 프로필 아이콘 ❶을 클릭한 다음, 드롭다운에서 Profile ❷을 선택하세요. 왼쪽 사이드바에서 API Tokens ❸을 클릭하세요.

2단계. 새 토큰 시작

API Tokens 페이지에서 오른쪽 상단의 파란색 + Create Token 버튼 ❹을 클릭하세요.

Create Token 버튼이 강조된 Cloudflare API Tokens 페이지

3단계. 올바른 템플릿 선택

Cloudflare는 여러 템플릿을 제공합니다. 아래로 스크롤하여 "Read and write to Cloudflare Stream and Images" 옆의 Use template을 클릭하세요 ❺. 이것이 올바른 템플릿입니다 — ReedTV에 필요한 정확한 권한을 부여합니다.

Read and write to Cloudflare Stream and Images 템플릿이 강조된 API token 템플릿 목록

커스텀 토큰을 선택하지 마세요 정확히 무엇을 하는지 모른다면. 가장 흔한 BYOA 업로드 실패는 Stream:Read만으로 만든 토큰입니다 — 검증은 읽기만 하므로 연결은 작동하지만, 업로드는 Stream:Edit이 필요해서 실패합니다. 위 템플릿이 둘 다 설정해 줍니다.

4단계. 토큰 설정 확인

템플릿이 권한을 미리 채워줍니다: Stream:Read, Stream:Edit, Cloudflare Images:Read, Cloudflare Images:Edit, Account Analytics:Read. 그대로 두세요.

Account Resources는 Include — All accounts로 그대로 두세요. Client IP Address Filtering은 비워두고 TTL도 비워두세요 — 둘 중 하나라도 추가하면 "어제는 업로드가 됐는데 오늘은 안 돼" 문제의 두 번째로 흔한 원인이 됩니다. Continue to summary ❻을 클릭하세요.

권한, Account Resources, IP 필터, TTL, Continue to summary 버튼을 보여주는 API token 설정 페이지

5단계. 검토 및 생성

Cloudflare가 토큰의 한 줄 요약을 보여줍니다: All accounts — Stream:Read, Stream:Edit, Cloudflare Images:Read, Cloudflare Images:Edit, Account Analytics:Read. 일치하는지 확인하고 Create Token ❼을 클릭하세요.

6단계. 토큰 즉시 복사

Cloudflare는 새 토큰(cfut_로 시작)을 단 한 번만 보여줍니다. 복사 아이콘 ❽을 클릭하고 안전한 곳에 붙여넣으세요 — 비밀번호 관리자가 이상적입니다. 복사하지 않고 페이지를 닫으면 토큰을 삭제하고 새로 만들어야 합니다.

새 토큰과 강조된 복사 버튼을 보여주는 API token 생성 성공 화면

2부 — Account ID 찾기

7단계. Cloudflare Stream 열기

Cloudflare 사이드바에서 Media를 펼치고 Stream → Videos를 클릭하세요. Stream 페이지의 오른쪽 Account details 아래에 Account ID가 보입니다 — 이 긴 16진수 문자열이 ReedTV에 필요한 것입니다.

오른쪽 Account details 패널에 Account ID가 강조된 Cloudflare Stream 개요 페이지

옆의 복사 아이콘을 클릭하여 토큰과 함께 저장하세요.

3부 — ReedTV에서 연결

ReedTV에 로그인하고 Settings → BYOA를 여세요.
Connect Cloudflare Stream account을 클릭하세요.
Account ID와 API Token을 붙여넣으세요.
Connect를 클릭하세요. ReedTV가 자격 증명을 검증하고 Stream이 활성화되어 있는지 확인하면 완료됩니다.

이제부터 모든 업로드는 사용자 본인의 Cloudflare Stream 계정으로 직접 라우팅됩니다. ReedTV는 동영상 파일을 만지지 않습니다 — 메타데이터만 저장하고 시청 / 임베드 페이지를 제공합니다.

문제 해결

"Cloudflare rejected your saved API token (Authentication error)"

토큰이 인증에서 거부되고 있습니다. 가능성 순서대로 일반적인 원인:

연결 후 Cloudflare 대시보드에서 토큰이 삭제되거나 재발급되었습니다. 새로 만들어 다시 연결하세요.
Cloudflare Workers IP를 제외하는 IP 필터가 추가되었습니다. IP 필터링 없이 다시 만드세요.
TTL 종료 날짜가 지났습니다. TTL 없이 다시 만드세요.

"Cloudflare account does not have Cloudflare Stream enabled"

아직 Stream을 구독하지 않았습니다. Cloudflare 대시보드에서 Stream → Videos로 이동하고 오른쪽 상단의 Manage plan을 클릭하세요. Stream 저장소는 1,000분당 $5부터 시작합니다.

"Your Cloudflare API token is missing the required permission"

토큰이 아마도 Stream:Read만으로 처음부터 만들어졌을 것입니다. 삭제하고 3단계로 돌아가서 Read and write to Cloudflare Stream and Images 템플릿을 사용하세요.

완료

연결되면 동영상이 완전히 사용자 본인의 Cloudflare Stream 계정에 저장되며, 저장소에 대해 Cloudflare에 직접 지불하고, ReedTV는 그 위에 대시보드, 분석, 임베드 커스터마이징, AI 자막, Patreon 친화적인 oEmbed 링크를 제공합니다.

무료 체험 시작하기