MoneyPrinterTurbo 설정

MoneyPrinterTurbo 는 주제나 키워드 하나를 완성된 짧은 동영상으로 만들어 줍니다. 스크립트를 작성하고, 소재를 검색하거나 생성하고, 자막과 배경음악을 추가한 뒤 렌더링합니다. OfoxAI는 이 프로젝트의 공식 스폰서이며, 그중 두 단계——AI 동영상 소재 생성과 스크립트 작성——가 기본 내장 옵션으로 통합되어 있어 하나의 OfoxAI API Key로 모두 사용할 수 있습니다.

이 가이드는 MoneyPrinterTurbo를 OfoxAI로 연결하는 방법만 다룹니다. 도구 자체의 설치 방법——uv, Docker, Windows 원클릭 패키지, 또는 Google Colab——은 공식 README 를 참고하세요.

사전 요구사항

OfoxAI 계정과 API Key(여기서 발급 )
MoneyPrinterTurbo가 설치되어 있고 프로젝트 루트에 config.toml이 있어야 함——앱을 처음 실행하면 config.example.toml에서 자동으로 복사됩니다

프롬프트 한 줄로 끝내는 에이전트 연동

MoneyPrinterTurbo는 공식 에이전트 스킬을 제공합니다. 터미널 명령을 실행할 수 있는 AI 에이전트라면——Claude Code도 그중 하나입니다——프롬프트 한 줄로 설치, 설정, 렌더링까지 끝낼 수 있습니다:


이 Skill을 사용하세요: https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/SKILL.md
AI가 일상생활을 어떻게 바꾸고 있는지에 대한 동영상을 만들어 주세요. 동영상 소재는 OfoxAI로 생성해 주세요.

에이전트는 config.toml에 이미 있는 설정을 그대로 재사용하고, 아직 없는 자격 증명만 요청합니다——OfoxAI 쪽은 MPT_OFOX_API_KEY입니다.

MPT_ 접두사에 주의하세요. MPT_OFOX_API_KEY는 에이전트 경로 전용이며, 아래 1단계에서 config.toml이 대체값으로 사용하는 OFOX_API_KEY가 아닙니다. 잘못 설정하면 이미 전달했다고 생각한 Key를 에이전트가 계속 요구하게 됩니다.

이 스킬은 기본적으로 무료 Pexels 스톡 영상을 사용하므로, 위처럼 OfoxAI 소재를 명시적으로 요청하세요. 그러지 않으면 결과물은 스톡 영상으로만 편집되고 OfoxAI 동영상 API는 한 번도 호출되지 않습니다. macOS와 Windows에서 동작하며 uv를 사용합니다.

설정 단계

1단계: OfoxAI를 동영상 소스로 설정

config.toml을 열고 video_source를 ofox로 지정하세요:

config.toml


video_source = "ofox"
 
ofox_api_key = "<당신의 OFOXAI_API_KEY>"
ofox_base_url = "https://api.ofox.run/v1"
ofox_text_to_video_model = "bytedance/seedance-2.0-fast"
ofox_resolution = "720p"
ofox_min_duration = 4
ofox_max_duration = 15
ofox_provider = "byteplus"

ofox_resolution, ofox_min_duration, ofox_max_duration은 ofox_text_to_video_model에 설정한 모델에서만 유효합니다——모델마다 허용 범위가 다릅니다. 모델을 바꾸면서 이 세 항목을 함께 갱신하지 않으면 작업이 생성되기도 전에 요청이 거부됩니다. 각 모델의 실제 한도는 동영상 모델에서, ofox_provider에 넣을 수 있는 값은 공급자 라우팅에서 확인하세요.

Key를 파일에 평문으로 남기고 싶지 않다면 ofox_api_key를 비워 두고 대신 환경 변수 OFOX_API_KEY를 설정하세요——MoneyPrinterTurbo가 자동으로 이 값을 대신 사용합니다.

WebUI에서 설정해도 됩니다. 먼저 메인 화면에서 동영상 소스를 OFox AI 동영상으로 선택하고, 설정 → 소재 소스 설정을 연 뒤 아래로 스크롤해 OfoxAI 블록을 찾으세요:

설정 → 소재 소스 설정 탭, 아래로 스크롤하면 OfoxAI 블록이 있음

OFox API Key, OFox 텍스트-투-비디오 모델, OFox Base URL, OFox 업스트림 제공자를 순서대로 채우세요:

OfoxAI 블록의 네 가지 필드

WebUI가 노출하는 필드는 ofox_api_key, ofox_text_to_video_model, ofox_base_url, ofox_provider 이 네 가지뿐입니다. ofox_resolution, ofox_min_duration, ofox_max_duration에 해당하는 UI 컨트롤은 없으며 config.toml에서 설정해야 합니다.

2단계: OfoxAI를 스크립트 작성 모델로 설정(선택 사항)

MoneyPrinterTurbo에 내장된 openai_* 필드는 OpenAI Chat Completions 호환 엔드포인트라면 무엇이든 동작합니다——OfoxAI도 예외가 아니며, 동일한 API Key를 그대로 재사용할 수 있습니다:

config.toml


llm_provider = "openai"
 
openai_api_key = "<당신의 OFOXAI_API_KEY>"
openai_base_url = "https://api.ofox.run/v1"
openai_model_name = "openai/gpt-5.5"

ofox_api_key와 달리 openai_api_key에는 환경 변수 대체가 없습니다——Key를 파일에 직접 입력하세요.

이 세 값은 WebUI에서 설정 → 대규모 모델 설정 아래에 있습니다 — 동영상 주제 입력란 옆의 모델 설정을 클릭하면 열립니다:

모델 설정을 클릭하면 설정 대화상자가 열림

이 페이지에는 「모델 연결 테스트」 버튼도 있습니다:

설정 → 대규모 모델 설정 탭

모델 ID에는 공급자 접두사가 필요합니다——gpt-5.5가 아니라 openai/gpt-5.5처럼 지정하세요. 전체 목록은 모델 마켓플레이스 에서 확인할 수 있습니다.

3단계: MoneyPrinterTurbo 시작

앱(Docker라면 컨테이너)을 재시작해 수정한 config.toml을 반영하세요. WebUI나 CLI에서 짧은 테스트 동영상을 생성해 렌더링이 완료되면 두 단계 모두 OfoxAI에 정상적으로 연결된 것입니다.

Docker 배포는 컨테이너 시작 시점에 config.toml을 읽으며, 실시간으로 반영되는 마운트가 아닙니다——docker compose up 이전에 파일을 수정해 배치하고, 이후 변경할 때마다 컨테이너를 재시작하세요.

비용 계산 방식

OfoxAI 소재는 완성된 동영상이 아니라 제출한 클립 단위로 과금됩니다——한 편의 동영상은 보통 여러 클립을 이어 붙여 만들기 때문에, 한 번 렌더링할 때 여러 건의 유료 작업이 생길 수 있습니다. 예산은 동영상 편수가 아니라 클립 개수를 기준으로 잡으세요.

두 경로 모두 비용을 통제합니다. WebUI는 스크립트가 제출할 유료 작업 수를 추산한 뒤, 「OFox 동영상 생성이 유료 작업을 만든다는 점을 이해했습니다」를 체크하기 전까지 렌더링을 시작하지 않습니다. 에이전트 경로에서는 스킬이 OFOX_CHARGE_CONFIRMATION_REQUIRED에서 멈추고, 사용자가 승인해 --confirm-ofox-charge와 함께 다시 실행할 때만 진행합니다. 제대로 동작하는 에이전트는 이 플래그를 스스로 붙이지 않습니다.

초당 단가는 모델마다 다르며 bytedance/seedance-2.0-mini가 가장 낮은 기준입니다——동영상 모델을 참고하세요. 스크립트 작성은 일반 채팅 토큰으로 과금되며, 소재 비용에 비하면 미미합니다.

자주 묻는 질문

과금이 발생하기 전에 작업 생성이 즉시 실패함 —— ofox_resolution, ofox_min_duration/ofox_max_duration, 또는 ofox_provider가 ofox_text_to_video_model에 설정된 모델과 맞지 않습니다. API는 이 값들을 모델 고유의 한도와 대조해, 맞지 않으면 작업 생성 전에 provider_type_unavailable이나 해상도/길이 오류로 거부합니다——과금은 발생하지 않습니다. 각 모델의 실제 한도는 동영상 모델에서 확인하세요.

이미 설정한 Key를 에이전트가 계속 요구함 —— 에이전트 경로가 요구하는 MPT_OFOX_API_KEY 대신 OFOX_API_KEY를 설정했거나, 그 반대로 설정한 경우입니다. 둘은 서로 다릅니다. MPT_OFOX_API_KEY는 스킬용이고, OFOX_API_KEY는 config.toml의 대체 변수입니다.

중국 본토에서 연결이 실패함 —— ofox_base_url을 미러 주소인 https://api.ofox.io/v1로 전환하세요. 동일한 API Key로 같은 서비스를 그대로 미러링합니다.

스크립트 생성이 모르는 사이에 잘못된 공급자를 사용함 —— openai_* 블록을 활성화하려면 llm_provider가 정확히 "openai"여야 합니다. 다른 값을 넣으면 openai_api_key를 채워 넣었더라도 스크립트 생성이 다른 공급자의 필드로 라우팅됩니다.

MoneyPrinterTurbo는 빠르게 반복 개발되고 있어 설정 필드가 버전에 따라 달라질 수 있습니다. 공식 config.example.toml 과 대조해 확인하세요.