AI 图片、视频和声音

BaseHalf 能根据画布上的内容生成图片、视频和声音。文件还不存在的卡片就是一张草稿：它存着提示词和设置，连到它的卡片就是它的输入。生成之后，它的文件会以卡片的名字出现在文件夹里。

创建草稿

• 在画布空白处双击，选择 New Image、New Video 或 New Audio。
• 或者从一张卡片拖出连接，在画布空白处松开，再选择 Image、Video 或 Audio。这张卡片会成为草稿的第一个输入。

新草稿名为 image、video 或 audio，扩展名取决于模型输出的格式，比如 image.png、video.mp4 或 audio.mp3，名字被占用时会加上编号。它会沿用你在这台 Mac 上最近一次生成同类内容时的服务商、模型和设置。新草稿会被选中，卡片下方打开它的面板，光标已经在提示词里。草稿在文件生成之前不会出现在文件列表里。

输入就是连接

草稿的输入就是它的上游连接，按顺序排列，每一个都会发送。

• 图片、视频和音频的用法取决于模型当前的模式：用作首帧和尾帧、参考素材，或者作为要延长、编辑的片段。
• 笔记和文本文件会接在你写的提示词后面，各带自己的名字。对语音模型来说，连到它的笔记就是要念的内容。
• 提示词上方的输入行按顺序把连接显示成小方块，拖动方块可以调整顺序。面板上有两个添加输入的按钮。Pick on Canvas 打开后，单击卡片就能连接或移除，直到按 Done 或 Escape。Import File… 把文件复制到卡片所在的文件夹并连上。
• 模型用不了的连接会被拒绝，并说明原因，比如把视频连到不接受视频的模型，或者图片比它能接受的多一张。
• 模式跟随输入。 当草稿的模式用不了所有连接时，面板会显示能用的模式，发送的也是那个模式。

提及

在提示词里输入 @ 可以提及文件。菜单按类型列出草稿的输入和这张画布上的卡片；选择还没连接的卡片时也会把它连上。提及显示为带文件名和缩略图的小标签，调整输入顺序或重命名文件后，它指向的还是那个文件。移除连接时，相应的提及也会从提示词中移除。

发送提示词时，每个提及都会写成所选模型指代输入的方式，所以同一段提示词在所有模型上都能用。

服务商和 key

BaseHalf 用你自己的 key，把每个请求直接发给服务商，中间没有 BaseHalf 的服务。BaseHalf 也不显示价格：一次生成花多少钱，在你申请 key 的服务商控制台里看。

在 Settings → BaseHalf → Providers 页面设置服务商。为每个服务商填写凭证；如果它有多个地区，再选一个。如果你使用的中转或私有网关与服务商自己的 API 一致，也可以填写它的地址。凭证加密保存在这台 Mac 上，绝不会放进你的文件夹。保存时不做检查，第一次生成时才知道能不能用。

• 视频：ByteDance、Kling、Alibaba、MiniMax、Vidu、Google、PixVerse、Luma、Runway、xAI、LTX 和 Black Forest Labs。
• 图片：ByteDance、Kling、Alibaba、MiniMax、Vidu、Google、Luma、Runway、xAI、Black Forest Labs 和 OpenAI。
• 声音：ElevenLabs、Fish Audio、Mureka、MiniMax 和 Google。

设置

每个模型只显示它接受的设置，比如模式、比例、时长或声音。More 打开高级设置，比如种子和反向提示词。切换模型时，新模型接受的值都会保留，其余恢复默认值。

输入可能会收窄设置的范围：比如时长受连接的视频影响时，会在下方说明原因。卡片无法生成时，Generate 会变暗，提示框里写明原因。如果原因在面板之外，比如服务商还没设置，会显示一行提示，并提供设置入口。

图片模型可以一次生成多张，每张各占一张卡片，排在第一张旁边。

声音

声音模型可以生成语音、音乐或音效，面板随模型变化。语音模型念出你的提示词或连到它的笔记，声音用面板上的 voice 按钮选择：服务商提供的声音，或者你账号里的声音。音乐模型根据描述生成歌曲，在 Lyrics 模式下则唱你写的歌词。一次生成多首歌时，每首各占一张卡片。

生成过程中

按 Generate 或 Cmd+Enter。进度显示在卡片上，关闭面板或切换到其他画布时生成不会中断。服务商接到任务之后，重新加载窗口或重启也不会中断。很多图片模型会直接返回文件，没有任务可以接回来：如果 BaseHalf 先关闭了，卡片会说明文件可能已经生成并计费，请你去服务商控制台确认。

• 停止按钮会结束生成，并在可能的情况下请服务商取消。
• 生成失败时，卡片显示服务商返回的信息并变回草稿：改好之后在同一张卡片上再次生成。
• 当 BaseHalf 无法确定请求是否到达服务商时，它会如实说明，并请你先去服务商控制台确认。它绝不会自行重发请求，因为第二次请求可能再次计费。

结果就是文件

生成好的图片、视频或声音会以草稿的路径存进文件夹，是一个普通文件，文件列表、访达、Git 和你的 Agent 都看得到，卡片上也会显示它。生成文件是怎么来的这份记录不会改变，修剪之后也一样。它的面板会显示生成它的输入、提示词、模型和设置。

想再试一次，选择 New Version。它会在卡片旁边新建一张草稿，提示词、输入和设置都相同，只有种子除外；在你按 Generate 之前不会生成。之前的结果绝不会被覆盖。想基于这个结果继续做，就从它的卡片连到一张新草稿。

Agent 也能生成

Agent 可以这样创建草稿：把提示词、模型和设置写进 .bh/mirror/<path>/generation.yaml，把输入写进 upstream.yaml，再在 Agent Area 的终端里用 basehalf --generate <path> 生成。这条命令不会要求确认，因为请求和 key 都是你的。对已生成的文件运行时，它会先创建一个新版本。它会打印将要生成的卡片，不会等文件生成完。Codex 的默认沙箱会拒绝这条命令。

basehalf --list-capabilities 会列出 Agent 可选的服务商、模型和设置，BaseHalf skill 里也有这些文件的说明。

下一步

• 连接：输入怎样连接和排序。
• 与 Agent 协作：在画布旁运行 Agent。