검토 2026-11-10 · API 버전 2026-11-09 · Markdown 읽기
인증과 product key
AiVideoEditor의 UI, REST API, MCP 어댑터는 워크스페이스 서비스를 공유해요. API 클라이언트는
소셜 네트워크 OAuth 토큰이나 데이터베이스 자격 증명이 아니라 product key를 사용해요.
올바른 워크스페이스에 로그인한 후 /app/developers에서 키를 만드세요. 평문
pk_v1_… 키는 한 번만 복사해서 시크릿 관리자나 보호된 로컬 환경에 저장하세요.
AiVideoEditor는 해시와 표시용 접두사만 보관해요.
키 보내기
curl --fail-with-body -sS \
-H "Authorization: Bearer $PUBLISHER_KEY" \
"$PUBLISHER_API_URL/api/v1/usage"
배포된 origin에는 HTTPS를 사용하세요. 자격 증명이 URL, 소스 관리, 채팅 프롬프트, 스크린샷, 로그에 노출되지 않게 하세요. 직접 스토리지 업로드는 반환된 서명된 URL과 헤더를 사용해요; AiVideoEditor bearer 키를 스토리지로 전달하지 마세요.
스코프와 계정 접근
| 스코프 | 기능 |
|---|---|
accounts:read | 계정, capabilities, TikTok 설정 조회 |
media:write | 업로드 예약, 확정 및 관리 |
posts:read | 게시물 목록 조회, 초안 검증, 상태 관찰 |
posts:write | 초안 생성 및 편집 |
posts:publish | 전송 게시, 예약, 취소, 재시도 |
usage:read | 워크스페이스 사용량 및 플랜 정보 조회 |
webhooks:manage | 웹훅 엔드포인트 등록, 목록 조회, 제거 |
스코프는 정확한 이름이지 계층이 아니에요. 통합에 필요한 것만 부여하세요. 키는
접근 가능한 계정 ID를 제한할 수도 있어요. 워크스페이스 멤버십, 실효 역할, 계정
제한, 플랜 상태는 여전히 적용돼요. posts:publish가 있는 키가 자동으로 초안
작성 접근을 얻는 게 아니에요.
기본 키 스코프 집합에는 posts:publish와 webhooks:manage가 빠져 있어요.
draft-only 에이전트는 보낼 권한 없이 검토할 작업을 준비할 수 있어요. 키는 다른
키를 만들거나 결제를 변경할 수 없어요.
폐기와 복구
유출된 키는 개발자 UI에서 폐기하세요. 먼저 대기 작업 수를 확인하세요: 폐기하면
미전송 작업이 requires_action 상태로 일시 중지돼요; 초안은 삭제되지 않아요.
적절한 접근 권한을 담은 대체 키를 만들고, 재개하기 전에 대기 작업을 검토하세요.
이미 외부로 전송된 제출을 폐기로 회수할 수 있다고 가정하지 마세요.
401은 자격 증명이 없거나 유효하지 않다는 뜻이에요. 403은 인증된 행위자에게
권한이나 계정 접근이 없다는 뜻이에요. 어느 쪽이든 반복해서 재시도해도 해결되지
않아요. errors and recovery를 참고하세요.