> ## Documentation Index
> Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Nodes

> Run BudgetPixel's hosted models as native ComfyUI nodes — 58 nodes covering image, video, music, sound effects, upscaling, lip sync, and motion control, wired into your graphs with your API key.

[ComfyUI-BudgetPixel](https://github.com/budgetpixel-ai/comfyui-budgetpixel) is the
official BudgetPixel node pack for [ComfyUI](https://www.comfy.org/). It adds one node
per model — **58 nodes** across image (FLUX 2, Seedream 5.0, Qwen-Image 3.0, Nano
Banana, GPT-Image…), video (Kling v3, Seedance, Wan, MiniMax…), music and sound
effects, upscaling, lip sync, and motion control — plus account utilities for live
credits and pre-flight cost estimates.

The nodes are thin clients for this API: each one submits a generation job, polls it,
and downloads the result into your graph as a normal `IMAGE`, `VIDEO`, or `AUDIO`
value. No local GPU or model downloads are needed for these nodes, and they compose
freely with the rest of your local node graph.

<Note>
  The nodes use the developer API, which is included in **every paid plan**. Generations
  are billed in credits from your plan, identically to budgetpixel.com — each node's help
  text shows its model's price, and the **BudgetPixel Cost Estimate** node returns the
  exact discount-aware cost before you run a graph.
</Note>

## Install

<Tabs>
  <Tab title="ComfyUI-Manager">
    1. Open **Manager → Custom Nodes Manager** in ComfyUI.
    2. Search for **BudgetPixel** and click **Install**.
    3. Restart ComfyUI.
  </Tab>

  <Tab title="comfy CLI">
    ```bash theme={null}
    comfy node install comfyui-budgetpixel
    ```
  </Tab>

  <Tab title="Git">
    ```bash theme={null}
    cd ComfyUI/custom_nodes
    git clone https://github.com/budgetpixel-ai/comfyui-budgetpixel.git
    pip install -r comfyui-budgetpixel/requirements.txt
    ```

    Then restart ComfyUI.
  </Tab>
</Tabs>

## Add your API key

[Create an API key](https://budgetpixel.com/settings/api-keys) (any paid plan), then
provide it one of two ways:

<Tabs>
  <Tab title="Environment variable">
    Set `BUDGETPIXEL_API_KEY` in the environment that launches ComfyUI:

    ```bash theme={null}
    export BUDGETPIXEL_API_KEY=bpx_live_...
    ```
  </Tab>

  <Tab title="Config file">
    Create `budgetpixel.json` inside the `comfyui-budgetpixel` folder:

    ```json theme={null}
    { "api_key": "bpx_live_..." }
    ```
  </Tab>
</Tabs>

<Info>
  Your key is **never stored in workflow JSON** — the nodes deliberately have no key
  widget, so workflows you share or publish stay safe to share. Since other custom nodes
  run in the same ComfyUI process, we recommend a **dedicated key** for ComfyUI that you
  can revoke independently at any time.
</Info>

## Use the nodes

Everything lives under **Add Node → BudgetPixel**, one submenu per category:

| Category | What's there |
| - | - |
| `BudgetPixel/Image` | Text-to-image, image editing, multi-reference composition. Image inputs are normal `IMAGE` connections; a batch feeds multi-reference models automatically. |
| `BudgetPixel/Video` | Text-to-video, image-to-video (start/end frame), reference-to-video, video editing. Outputs are core `VIDEO` values for Save Video or frame extraction. |
| `BudgetPixel/Audio` | Music generation and sound effects. Video-to-SFX and video-to-music take a `VIDEO` input; Sonilo Video SFX also returns your clip with the effects mixed in. |
| `BudgetPixel/Upscale` | Image upscalers and Topaz Labs video upscaling. |
| `BudgetPixel/Lip Sync`, `BudgetPixel/Motion Control` | Talking-head sync from `IMAGE`/`VIDEO` + `AUDIO`; motion transfer from a reference video. |
| `BudgetPixel/Account` | Live credit balance and exact pre-flight cost estimates. |

Generation runs on BudgetPixel's side: nodes show progress, poll until the job
succeeds, then pull the result into the graph. Local media inputs (frames, clips,
audio) are pushed through [temporary uploads](/api-reference/files/upload-a-file)
automatically. Interrupting a ComfyUI run stops the wait, but a job that was already
submitted keeps running — and billing — server-side.

The pack ships example workflows (text-to-image, image-to-video, sound effects) that
appear in ComfyUI's template browser after install.

<Note>
  Video and audio nodes return ComfyUI's core `VIDEO`/`AUDIO` types — use a 2025-or-newer
  ComfyUI.
</Note>

## How it maps to this API

Every node corresponds to one [model endpoint](/api-reference) — the node's widgets are
exactly that endpoint's parameters, generated from this API's OpenAPI spec. New models
added to the API ship as new nodes in the next pack release. Under the hood the nodes
follow the standard [async job flow](/concepts/async-jobs); everything documented there
(statuses, output retention, rate limits) applies unchanged.

Source, issues, and releases: [github.com/budgetpixel-ai/comfyui-budgetpixel](https://github.com/budgetpixel-ai/comfyui-budgetpixel) ·
Registry listing: [registry.comfy.org](https://registry.comfy.org/publishers/budgetpixel-ai/nodes/comfyui-budgetpixel)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.