AiVideoEditor
무료로 시작하기
메뉴

검토 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를 참고하세요.