Nodes/Comfyui-zhenzhen/Zhenzhen_sora2
ComfyUI Node

Zhenzhen_sora2

Sora 2 video from your ComfyUI canvas, no OpenAI account required

By T8mars·Created 12 months ago·Updated a day ago· 719
Zhenzhen_sora2
  • image1
  • image2
  • image3
  • image4
  • video
  • video_url
  • response
prompt
modelsora-2
aspect_ratio16:9
duration15
hdfalse
apikey
seed0
privatetrue
skip_errorfalse

Sora 2 is OpenAI's flagship text-to-video model, and unless you're running an API budget you'll never touch it directly. Comfly_sora2 is the ComfyUI front door: it sends your prompt to the Comfly relay, polls the generation until it's done, and hands you a VIDEO object you can preview and save on the canvas. Your GPU does nothing. You pay the relay per clip.

This is one of the heavier nodes in the Comfyui_Comfly pack - a single generation can take minutes, and the node will hold your queue open while it waits. That's normal. The whole pack is a set of API relays to ai.comfly.chat, all sharing one API key from that site.

What you set

  • prompt - the video description. Keep it cinematic; Sora rewards scene-setting.
  • model - sora-2 or sora-2-pro. The pro tier unlocks HD and longer clips.
  • aspect_ratio - 16:9 landscape or 9:16 portrait. No square, no custom.
  • duration - 10, 15, or 25 seconds. Read the constraints below before you combine this with anything.
  • hd - high definition. Only sora-2-pro accepts it; the plain model refuses.
  • private (optional, default true) - whether the video is published. If true it's hidden from the feed, but you also lose the ability to re-edit ("remix") it later. Flip it false only if you want the video shareable/remixable.
  • image1image4 (optional) - reference images for image-to-video or multi-image conditioning. They're base64-encoded and sent with the prompt.

The gotchas are coded into the node: 25s and hd together is a hard error, and sora-2 (non-pro) rejects both 25s and hd outright. The node returns a clean JSON error in response instead of crashing, but check that output before assuming success.

Outputs

video - a ComfyUI VIDEO object you can wire straight into the built-in Save Video / preview nodes (the README explicitly calls this out). video_url is the hosted link, task_id identifies the job on the relay (the author's dashboard shows async task status there), and response is the JSON status blob, error included. If the relay's sora-2 endpoint is having a bad day, the task_id and response combo is how you'll find out.

Install and key

ComfyUI Manager, search "Comfyui_Comfly", install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/ainewsto/Comfyui_Comfly

Grab an API key at ai.comfly.chat and put it in the required apikey field (it's saved to the pack's Comflyapi.json). The relay is paid and prepaid; a failed task refunds the money, so a hard error isn't a total loss. README caveats: only tested on Windows 11, and the quality tier you get for the base sora-2 model is capped at standard-def 10s or 15s in practice.

The honest take

This is a "pay for the model you can't run" node, and it does that job fine. Just set expectations: it's an async relay, so expect multi-minute waits, and the hd/25s limits mean the headline features only exist on the pro tier. If you want Sora-2-grade video in a ComfyUI pipeline without a second mortgage on API credits, this is a reasonable middle ground - for everything else, a local video model is still the better long-term home.

Categoryzhenzhen/Openai

Inputs (13)

NameTypeDefaultDescription
promptSTRING
modelCOMBOsora-23 options: sora-2, sora-2-pro, sora-2-vip
aspect_ratioCOMBO16:92 options: 16:9, 9:16
durationCOMBO153 options: 10, 15, 25
hdBOOLEANfalse
apikeySTRING
image1optIMAGE
image2optIMAGE
image3optIMAGE
image4optIMAGE
seedoptINT00–2147483647
privateoptBOOLEANtrue
skip_erroroptBOOLEANfalse开启后,节点失败时不报错、按旧行为返回默认空结果;关闭时(默认)失败直接抛出错误。

Outputs (3)

NameTypeDescription
videoVIDEO
video_urlSTRING
responseSTRING