心宝❤视频生成Sora
Sora 2 video in your ComfyUI graph — including the character feature, for a price
- image
- 角色参考视频
- video
- text
- videos
OpenAI's Sora 2 is closed, API-only, and quite expensive. If you still want it inside a ComfyUI workflow, the realistic paths are Comfy's official Partner Nodes or a wrapper like 心宝❤视频生成Sora (XinbaoVideoGenerator) from the comfyui-banana-li-linux pack. This one is Chinese-first - it accepts prompts in Chinese (the default prompt is literally "让这段文字生成一段视频", "turn this text into a video") - and it's the pack's answer to getting Sora clips as VIDEO tensors on your canvas.
The display name was recently changed to add "Sora" precisely so people can tell it apart from the pack's sibling Veo node, which you should check out if that's the model you actually want. The two are separate nodes with separate model lists.
How it works
You feed it a prompt (and optionally a reference image), it submits the request to a reseller endpoint using one of several network routes (线路: 香港专线/香港 line, 直连美区/direct US, CF专线/Cloudflare, or 心宝❤新渠道/the new channel), then polls for status and progress - the Sora branch always polls; the streaming/SSE option only affects the Veo node. Finished clips download into the pack's XinbaoVideos folder, tasks are logged in history.toml, and a "🎬 心宝视频任务" panel bottom-right shows progress. Like every API node in this pack, nothing runs on your GPU and every generation is billed.
The inputs that matter
- prompt - required, supports Chinese.
- banana_api_key - empty means it reads
config.inior a global key. - model_type -
sora-2-10s(the legacy default),sora-2-15s, and the pro tier:sora-2-pro-10s/sora-2-pro-15s/sora-2-pro-25s. The pro models are where the cost really lands. - aspect_ratio - 横版 (landscape 16:9) or 竖版 (portrait 9:16).
- batch_size - 1 to 8 with a 2-second stagger. Start at 1.
- image - optional reference image; over 5MB it auto-compresses before upload.
- seed - present, but the tooltip is honest: the API may ignore it. Don't build reproducibility on it.
The character feature is the reason to pick this node
Sora 2 can create a reusable character from a reference video, referenced by @username. This node wraps the whole dance:
- 角色参考视频 (character reference video) - a 3-10 second clip, clear front-facing framing works best.
- 启用角色 - on, and a single batch item creates the character and generates in one request; in batch mode it creates the character first, gets the
@username, then reuses it so you don't create duplicates. - 仅创建角色 - upload the reference, get back the
@username, and pass the reference video straight through without generating anything new. Handy for building your roster first. - 保存角色到提示词助手 - when a character is created, write the
@usernameinto the pack's prompt-assistant library (snippets.toml, category Sora). That's the pack's own nodes talking to each other, and it's a nice touch.
Outputs: video, videos (batch list), and text (status/errors - in workflow-concurrency mode a failed node reports here rather than killing the graph).
Installing
cd ComfyUI/custom_nodes
git clone https://github.com/98624017/comfyui-banana-li-linux
Restart ComfyUI, or install via ComfyUI Manager searching "banana-li-linux". This is the Linux build - Windows uses comfyui-banana-li, macOS comfyui-banana-li-mac.
Where people get burned
- Cost.
sora-2-pro-25sat batch 8 is a lot of money for one run. The README's "validate small first" advice is the pack's own. Meter your spend. - The route/line system is a maze. Old channels (香港专线, 直连美区, CF专线) vs the new channel, and keys that start with
fixsk-auto-route to a hidden channel. If your key suddenly stops working, check the route dropdown before anything else. - Submit-only mode is Sora-only. The 仅提交不等待 toggle writes the task to
history.tomland returns immediately - check the bottom-right task panel. For Veo you'd use the Veo node; this option won't do it. - Your image leaves the machine. The reference is uploaded to an image bed and submitted as a URL. That's how the API works; don't feed it anything you'd mind leaving home.
- Same security grain as every node in this pack. It's a third-party wrapper that holds your key, makes network calls by design, and ships compiled
.somodules you can't read. The standing advice for the category - know what a fresh pack does before you paste a key in - applies here with extra force.
If you specifically want Sora 2's character consistency and can stomach the per-clip pricing, this is a functional way to get it into ComfyUI without a Comfy account or credits. Go in with your batch at 1 and your eyes open.
Inputs (17)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | 让这段文字生成一段视频 | 视频生成的提示词,支持中文 |
| banana_api_key | STRING | 调用服务的 API Key;留空则读取 config.ini | |
| model_type | COMBO | sora-2-10s | 选择视频生成模型(sora-2-10s 为旧值兼容;sora-2-pro-* 通过 seconds/size 控制) |
| aspect_ratio | COMBO | 横版 | 横板=landscape (16:9),竖版=portrait (9:16) |
| batch_size | INT | 11–8 | 一次生成的视频数量,最大并发8,每个请求间隔2秒启动 |
| 启用工作流并发opt | BOOLEAN | false | 启用后,多个 BananaV2/视频节点可在同一工作流中并发发起 API 调用;默认关闭以保持更保守的资源占用。开启并发时单节点失败不会终止整图。 |
| 仅提交不等待opt | BOOLEAN | false | 仅提交任务(写入 history.toml)并立即返回,不等待轮询与下载;进度请在右下角“🎬 心宝视频任务”查看(仅支持 Sora,Veo 请使用 Veo 专用节点) |
| seedopt | INT | -1-1–2147483647 | 随机种子,-1 为自动随机;接口当前可能忽略该字段 |
| imageopt | IMAGE | 可选的参考图;>5MB 自动压缩;Sora 会上传图床并以 JSON 的 image=url 方式提交;Veo 会上传图床 | |
| 流式模式opt | BOOLEAN | true | 仅 veo3.1 生效:开启 SSE 流式返回(带进度,默认);Sora 分支固定轮询 status/progress |
| 绕过代理opt | BOOLEAN | false | 梯子不稳定时可开启,强制直连 |
| 禁用SSL验证opt | BOOLEAN | false | 关闭证书校验(仅在信任网络环境时使用) |
| 线路opt | COMBO | 心宝❤新渠道 | 线路选择,fixsk- 密钥会自动使用隐藏线路 |
| 启用角色opt | BOOLEAN | false | 仅 Sora 生效:单批次优先按文档使用 video+prompt 单次请求创建角色并生成;批量模式为避免重复创建,将先创建角色拿到 @username 再复用生成 |
| 仅创建角色opt | BOOLEAN | false | 仅 Sora 生效:只上传角色参考视频创建角色并返回 @username(不生成新视频);视频输出将原样透传角色参考视频 |
| 保存角色到提示词助手opt | BOOLEAN | false | 仅 Sora 生效:当角色创建成功返回 @username 时,将其作为提示词片段写入 snippets.toml(category=Sora,color=#FF9800);默认关闭 |
| 角色参考视频opt | VIDEO | 仅 Sora 生效:角色参考视频(建议 3-10 秒,清晰正面更佳) |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| video | VIDEO | — |
| text | STRING | — |
| videos | VIDEO | — |