# MoneyPrinterTurbo 接入 OfoxAI 配置指南

Source: https://ofox.io/zh/docs/integrations/moneyprinterturbo

[MoneyPrinterTurbo](https://github.com/harry0703/MoneyPrinterTurbo?utm=ofox_ai) 能把一个主题或关键词做成一条完整的短视频：写脚本、匹配或生成素材、加字幕和配乐，最后合成成片。OfoxAI 是该项目的官方赞助商，其中两个环节——AI 视频素材生成、脚本创作——已作为内置选项接入，用同一个 OfoxAI API Key 即可开启。

本指南只讲如何把 MoneyPrinterTurbo 指向 OfoxAI。工具本身的安装方式——`uv`、Docker、Windows 一键启动包或 Google Colab——请参考[官方 README](https://github.com/harry0703/MoneyPrinterTurbo?utm=ofox_ai)。

## 前提条件

- 已注册 OfoxAI 账号并获取 API Key（[前往获取](https://app.ofox.io)）
- 已安装 MoneyPrinterTurbo，项目根目录下有 `config.toml`——首次启动时应用会自动从 `config.example.toml` 复制生成

## 一句话 Agent 接入

MoneyPrinterTurbo 发布了官方 agent skill。任何能执行终端命令的 AI Agent（Claude Code 也在其列）都能凭一段 prompt 完成安装、配置和出片：

```text
使用这个 Skill：https://raw.githubusercontent.com/harry0703/MoneyPrinterTurbo/main/docs/skill/SKILL.md
帮我生成一个主题为"人工智能如何改变普通人的日常生活"的视频，视频素材用 OfoxAI 生成。
```

Agent 会复用 `config.toml` 里已有的配置，只索要仍然缺失的凭据——OfoxAI 这边是 `MPT_OFOX_API_KEY`。

注意 `MPT_` 前缀：`MPT_OFOX_API_KEY` 只属于 agent 路径，**不是**下面第 1 步里 `config.toml` 回退用的 `OFOX_API_KEY`。设错那一个，agent 会一直向你索要一个你以为已经给过的 Key。

这个 skill 默认用免费的 Pexels 素材库，所以要像上面那样明确要求用 OfoxAI 生成素材，否则成片只会从存量素材里剪，根本不会调用 OfoxAI 视频接口。它支持 macOS 和 Windows，依赖 `uv`。

## 配置步骤

### 第 1 步：把 OfoxAI 设为视频素材来源

打开 `config.toml`，将 `video_source` 指向 `ofox`：

```toml filename="config.toml"
video_source = "ofox"

ofox_api_key = "<你的 OFOXAI_API_KEY>"
ofox_base_url = "https://api.ofox.io/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` 里设置的那个模型有效——每个模型的可接受范围各不相同。切换模型却不同步改这三项，请求会在创建任务前就被拒绝。各模型的真实限制见[视频模型](https://ofox.io/zh/docs/api/videos/models)，`ofox_provider` 可填的值见[供应商路由](https://ofox.io/zh/docs/api/videos/provider-routing)。

如果不想把 Key 明文写进文件，可以留空 `ofox_api_key`，改为在环境变量里设置 `OFOX_API_KEY`——MoneyPrinterTurbo 会自动回退读取它。

也可以在 WebUI 里配：先在主界面把视频来源选为 **OFox AI 视频**，再打开 **设置 → 素材来源设置**，下拉找到 **OfoxAI** 区块：

![设置 → 素材来源设置标签页，下拉可找到 OfoxAI 区块](https://ofox.io/screenshots/moneyprinterturbo/01-material-source-tab.png)

依次填写 OFox API Key、OFox 文生视频模型、OFox Base URL、OFox 上游厂商：

![OfoxAI 区块的四个字段](https://ofox.io/screenshots/moneyprinterturbo/02-ofox-fields.png)

WebUI 只暴露这四个字段——`ofox_api_key`、`ofox_text_to_video_model`、`ofox_base_url`、`ofox_provider`。`ofox_resolution`、`ofox_min_duration`、`ofox_max_duration` 根本没有界面控件，只能在 `config.toml` 里改。

### 第 2 步：把 OfoxAI 设为脚本创作模型（可选）

MoneyPrinterTurbo 内置的 `openai_*` 字段兼容任意 OpenAI Chat Completions 协议的端点——OfoxAI 也不例外，且可以复用同一个 API Key：

```toml filename="config.toml"
llm_provider = "openai"

openai_api_key = "<你的 OFOXAI_API_KEY>"
openai_base_url = "https://api.ofox.io/v1"
openai_model_name = "openai/gpt-5.5"
```

和 `ofox_api_key` 不同，`openai_api_key` 没有环境变量回退——请直接把 Key 写进文件。

这三个值在 WebUI 里位于 **设置 → 大模型设置**：点击主界面「视频主题」旁边的 **配置大模型** 即可打开：

![点击配置大模型打开设置弹窗](https://ofox.io/screenshots/moneyprinterturbo/03-llm-provider-entry.png)

设置页里还有一个「测试模型连接」按钮：

![设置 → 大模型设置标签页](https://ofox.io/screenshots/moneyprinterturbo/04-llm-provider-settings.png)

模型 ID 需要带供应商前缀——写 `openai/gpt-5.5`，而不是裸的 `gpt-5.5`。完整目录见[模型广场](https://ofox.io/zh/models)。

### 第 3 步：启动 MoneyPrinterTurbo

重启应用（Docker 部署则重启容器），让它读取修改后的 `config.toml`。在 WebUI 或 CLI 里生成一段测试视频，能顺利出片即说明两个环节都已连通 OfoxAI。

Docker 部署在容器启动时读取 `config.toml`，不是热加载挂载——请在 `docker compose up` **之前**把文件编辑好并放到位，之后每次改动都需要重启容器才生效。

## 费用怎么算

OfoxAI 素材是**按提交的每条片段计费，不是按成片计费**——而一条成片通常由好几段片段剪成，所以跑一次渲染可能产生好几个付费任务。做预算时要按片段数算，不是按视频条数算。

两条路径都有费用闸门。WebUI 会按脚本长度估算这次将提交多少个付费任务，不勾选「我已了解 OFox 视频生成会创建付费任务」就不让开始渲染。agent 路径则是 skill 遇到 `OFOX_CHARGE_CONFIRMATION_REQUIRED` 停下等你确认，确认后才带 `--confirm-ofox-charge` 重跑；行为正常的 agent 不会自己加这个 flag。

每秒单价随模型不同，最低从 `bytedance/seedance-2.0-mini` 起，详见[视频模型](https://ofox.io/zh/docs/api/videos/models)。脚本创作按普通对话 token 计费，相比素材费用可以忽略。

## 推荐模型

- **视频** —— [12 个 OfoxAI 视频模型](https://ofox.io/zh/docs/api/videos/models)都能填进 `ofox_text_to_video_model`；上面默认用的 `bytedance/seedance-2.0-fast` 起步价最低，`alibaba/wan-3.0` 或 `bytedance/seedance-2.5` 可以做到 30 秒长片。
- **脚本创作** —— [模型广场](https://ofox.io/zh/models)里的任意对话模型都能填进 `openai_model_name`。

## 常见问题

**任务创建就直接失败，还没产生计费** —— `ofox_resolution`、`ofox_min_duration`/`ofox_max_duration` 或 `ofox_provider` 和 `ofox_text_to_video_model` 里设置的模型对不上。API 会先按该模型的真实限制校验，不匹配就在创建任务前拒绝，报 `provider_type_unavailable` 或分辨率/时长错误——不会产生费用。各模型的真实限制见[视频模型](https://ofox.io/zh/docs/api/videos/models)。

**Agent 反复索要一个你已经设过的 Key** —— 你把 Key 设成了 `OFOX_API_KEY`，而 agent 路径要的是 `MPT_OFOX_API_KEY`，或者正好设反。两者互不相通：`MPT_OFOX_API_KEY` 给 skill 用，`OFOX_API_KEY` 是 `config.toml` 的回退变量。

**中国大陆网络连接失败** —— 把 `ofox_base_url` 换成镜像地址 `https://api.ofox.io/v1`，同一个 API Key 通用，服务完全一致。

**脚本生成悄悄走错了供应商** —— `llm_provider` 必须精确填 `"openai"` 才会激活 `openai_*` 那组字段；填了别的值，脚本生成会走向另一个供应商的字段，哪怕 `openai_api_key` 已经填好也不例外。

MoneyPrinterTurbo 迭代很快，配置字段可能随版本变化。请以[官方 config.example.toml](https://github.com/harry0703/MoneyPrinterTurbo/blob/main/config.example.toml?utm=ofox_ai) 为准核对。