Have a ComfyUI workflow? Get a readable Workflow Doc in your browser.Make a workflow readable.Try it now ↗
ComfyUI node package for BYOK (bring-your-own-key) access to external generative APIs: Gemini, Veo, and more via LiteLLM.
Package profile
README
BYOK (bring-your-own-key) ComfyUI nodes for generating video through external providers — Gemini/Veo, OpenAI Sora, Azure, and RunwayML — via LiteLLM. No local GPU-hungry model required; you supply your own provider API key and pay that provider directly.
text-to-video works for all providers; image-to-video (a reference image guiding the animation) works for Gemini/Veo only. Text-to-image is planned as a separate node — see .
Sources
3 sourcesVerified Sep 12
Source excerpts
1 excerptSource context: Repo andy-ratsirarson/ComfyUI_ExternalAPI
| Provider | provider value | Models | Aspect ratios | Resolutions | Duration |
|---|---|---|---|---|---|
| Google Gemini (Veo) | gemini | Fetched live from your account via google-genai; falls back to a built-in list (veo-3.1-fast-generate-preview, veo-3.1-fast-generate-001, veo-3.1-generate-preview, veo-3.1-generate-001, veo-3.1-lite-generate-preview, veo-2.0-generate-001) if that fails | 16:9, 9:16 | 1K, 2K | 4–8s |
| OpenAI (Sora) | openai | sora-2, sora-2-pro, sora-2-pro-high-res | 16:9, 9:16 | 1K, 2K | 4–12s* |
| Azure OpenAI (Sora) | azure | sora-2, sora-2-pro, sora-2-pro-high-res | 16:9, 9:16 |
* OpenAI/Azure's upper duration bound isn't published by the provider; 12s is a conservative default rather than a confirmed hard limit.
Gemini's model list is fetched live from google.genai.Client().models.list() at node-registration time when a Gemini API key is available on the ComfyUI server, so new Veo releases show up automatically without an update to this package.
Image-to-video (a reference image conditioning the result) is currently supported for Gemini/Veo only. The other providers are text-to-video only for now — see Roadmap. The models, aspect ratios, resolutions, and durations in the table above apply to both text- and image-to-video.
comfy_api.latest).requirements.txt):
litellm==1.92.0google-genai==1.47.0Via ComfyUI Manager: search for ComfyUI_ExternalAPI and install.
Manually:
cd ComfyUI/custom_nodes
git clone https://github.com/andy-ratsirarson/ComfyUI_ExternalAPI.git
cd ComfyUI_ExternalAPI
pip install -r requirements.txt
Restart ComfyUI afterward.
Set the environment variable(s) for whichever provider(s) you plan to use on the machine running the ComfyUI server, then restart ComfyUI.
| Provider | Environment variable(s) |
|---|---|
| Gemini | GEMINI_API_KEY (or GOOGLE_API_KEY) |
| OpenAI | OPENAI_API_KEY |
| Azure OpenAI | AZURE_API_KEY, AZURE_API_BASE (your endpoint), AZURE_API_VERSION (optional) |
| RunwayML | RUNWAYML_API_SECRET (or RUNWAYML_API_KEY) |
The node also has an optional api_key input that overrides the environment variable for that run. Prefer the environment variable. Anything typed into api_key gets saved into the workflow JSON and into output file metadata — so it can leak if you share a workflow or an output file. Only use it for quick one-off testing.
Nodes in this pack
1 nodeVerified Sep 12
| 1K, 2K |
| 4–12s* |
| RunwayML | runwayml | gen3a_turbo, gen4_turbo, gen4_aleph, gen4_image, gen4_image_turbo | 16:9, 9:16 | 1K, 2K | 5s or 10s |