BYOK·모델 연결
내 API 키로 AI 영상 생성하기: BYOK 설정과 요금 구조
제공업체의 API 주소와 모델을 연결하고 필요한 영상 입력을 지원하는지 확인하세요. 작업 공간 이용료와 모델 사용료, 로컬 키 저장과 백엔드 요청의 차이를 설명합니다.
목차
요금 페이지에서 BYOK 설정 열기
이미 제공업체 계정이나 중계 서비스 키가 있다면 BYOK로 Say Action 캔버스에서 사용할 수 있습니다. 요금 페이지에서 BYOK 요금제를 선택하고 서비스 상태와 현재 가격을 확인하세요. 이용 권한 활성화가 필요하면 결제를 완료합니다. 로그인 후 ‘내 모델 연결 (BYOK)’을 눌러 설정의 해당 항목(/settings?section=channels)을 엽니다. 이용 가능 여부는 사이트 기능 설정과 서비스 상태에 따라 달라집니다.
모델 채널 설정에 제공업체의 Base URL, API 키, 프로토콜, 모델 ID를 입력하세요. 영상 노드로 돌아가 채널과 모델을 선택하고 화면 비율, 길이, 입력 모드를 확인합니다. 대표 샷 하나를 시험하세요. 에피소드를 제작하기 전에 엔드포인트가 영상을 반환하는지, 작업 결과를 가져올 수 있는지 확인합니다.
작업 공간 이용료와 모델 사용료 구분하기
환경 서비스 요금 (6개월): USD 29.00 / 6개월. 작업 공간 서비스 요금이며 모델 사용량은 포함하지 않습니다. API 비용은 별도입니다.
BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.
크레딧은 채널 가격 기준 추정치이며, 실제 차감은 관리자 백엔드에 설정된 가격 등급을 따릅니다. 초 단위 영상 과금은 요청 초 수 기준 사전 승인입니다. 업스트림 실제 출력이 요청을 초과하면 소액의 차액이 발생할 수 있습니다.
플랫폼 모델로 다시 전환하면 해당 모델의 크레딧 규칙이 적용됩니다. BYOK를 함께 사용하더라도 플랫폼 모델에는 자체 크레딧 규칙이 적용됩니다. 제공업체의 잔액, 재시도 비용, 환불 규칙은 해당 업체 대시보드에서 확인하세요.
프로토콜 이름만으로 영상 지원을 판단할 수 없음
모델 채널 설정에 Base URL과 API 키를 입력한 뒤 제공업체 문서에 따라 API 방식, 모델 ID와 필요한 헤더를 설정하세요. 생성 전에 원하는 이미지·영상 생성 방식을 지원하는지 확인하세요. 경로, 해상도와 시작·끝 프레임 입력은 연결한 채널에 따라 다릅니다. 미지원 채널의 연동 신청이 호환성 보장을 뜻하지는 않습니다.
중계 서비스의 모델 목록에 이름이 있다고 해서 이미지 기반 영상 생성, 시작·끝 프레임, 참고 이미지를 지원하는 것은 아닙니다. 제공업체 문서와 노드에 실제로 표시되는 설정을 확인하세요. 모델 이름을 바꿔도 입력 모드가 추가되지는 않습니다. 연동을 신청할 때는 키와 민감한 헤더를 제거한 공개 API 문서를 제공하세요.
키는 로컬에 저장되지만 요청은 백엔드를 경유
키는 계정별로 분리된 브라우저 비밀 정보 저장소에 보관됩니다. BYOK 채널 연결 정보에는 모델 키가 아닌 제공업체의 오리진이 기록됩니다. 키를 로컬에 저장한다고 요청까지 기기 안에 머무는 것은 아닙니다. 개인 모델 요청은 로그인 인증된 백엔드를 거치며 작업 실행에 인증 정보를 백엔드로 보내야 할 수 있습니다.
신뢰하는 제공업체만 연결하고 운영 환경에서는 HTTPS를 사용하세요. 요청은 로그인 인증된 백엔드를 거쳐 전달되며 필요한 프롬프트, 참고 자료와 인증 정보가 요청에 사용됩니다. API 키, 비밀번호나 비밀 정보가 든 헤더를 공개 캔버스, 스크린샷 또는 지원 신청에 포함하지 마세요.
컴퓨터나 브라우저를 바꾸면 채널을 다시 설정할 수 있도록 준비하세요. 키가 포함된 설정을 프로젝트 에셋으로 공유하지 마세요. 유출 가능성이 있다면 제공업체에서 키를 폐기하거나 교체하세요. Say Action에서 키를 지워도 제공업체의 키가 폐기되지는 않습니다.
내 API 채널과 외부 API 중계 서비스 연결하기
모델 채널 설정에 Base URL과 API 키를 입력한 뒤 제공업체 문서에 따라 API 방식, 모델 ID와 필요한 헤더를 설정하세요. 생성 전에 원하는 이미지·영상 생성 방식을 지원하는지 확인하세요. 경로, 해상도와 시작·끝 프레임 입력은 연결한 채널에 따라 다릅니다. 미지원 채널의 연동 신청이 호환성 보장을 뜻하지는 않습니다.
BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.
신뢰하는 제공업체만 연결하고 운영 환경에서는 HTTPS를 사용하세요. 요청은 로그인 인증된 백엔드를 거쳐 전달되며 필요한 프롬프트, 참고 자료와 인증 정보가 요청에 사용됩니다. API 키, 비밀번호나 비밀 정보가 든 헤더를 공개 캔버스, 스크린샷 또는 지원 신청에 포함하지 마세요.
자주 묻는 질문
BYOK 이용료에 제공업체의 영상 생성 비용도 포함되나요?
작업 공간 서비스 요금이며 모델 사용량은 포함하지 않습니다. API 비용은 별도입니다.
OneAPI나 NewAPI를 연결할 수 있나요?
BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.
플랫폼 생성이 실패하면 크레딧은 어떻게 되나요?
모델 제공업체가 생성 실패를 명확히 확인하면 임시로 확보한 크레딧을 돌려드립니다. 연결이 끊기는 등 결과나 요금을 확인할 수 없을 때는 중복 정산을 막기 위해 확인 대기 상태로 둡니다.
OneAPI, NewAPI와 사용자 지정 헤더를 연결할 수 있나요?
BYOK에서는 API 주소, 모델 키와 사용자 지정 헤더를 설정할 수 있습니다. OneAPI나 NewAPI 같은 중계 서비스를 쓸 때는 실제 API에 맞는 OpenAI, Gemini 또는 Claude 방식을 선택하고 모델 ID와 이미지·영상 API 지원 여부를 확인하세요. 모든 중계 서비스나 비공개 규격이 자동으로 호환되는 것은 아닙니다. BYOK 모델 호출에는 플랫폼 추가 마진이나 생성 크레딧 차감이 없지만, 작업 공간과 모델 제공업체 이용료는 별도로 청구됩니다.