diff --git a/README.md b/README.md index 5fa6b5d..2faf19e 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# Comfy UI KIE API Nodes +# ComfyUI KIE API Nodes ## Project overview A set of ComfyUI custom nodes that connect to the Kie.ai API for image and video generation workflows. @@ -20,7 +20,7 @@ This node pack currently includes the following nodes: ### Generation Nodes - **Nano Banana Pro Image** - - Image generation node using the Googles Nano Banana Pro model via the Kie.ai API. + - Image generation node using the Googles Nano Banana Pro model - **Seedream Text-to-Image / Edit** - Text-to-image and image-editing node for Seedream models. @@ -30,16 +30,27 @@ This node pack currently includes the following nodes: - Generates video from a single input image. - Uses the Kling 2.6 image-to-video model. -- **Kling 2.6 Motion-Control Image-to-Video** - - Image-to-video generation with additional motion control parameters. - - Designed for more directed camera and motion behavior. - - **Kling 2.6 Text-to-Video** - Generates video directly from a text prompt. - Supports aspect ratio, duration, and sound options as exposed by the API. +- **Kling 2.6 Motion-Control Image-to-Video** + - Image-to-video generation with additional motion control parameters. + - Designed for more directed camera and motion behavior. + +- **Seedance V1 Pro (Fast) Image-to-Video** + Fast image-to-video generation optimized for quick iteration. + +- **Seedance 1.5 Pro Image-to-Video, Text-to-Video** + Higher-quality image-to-video generation using the Seedance 1.5 Pro model. + + ### Utility / Helper Nodes +- **Get Remaining Credits** + - Return number of credits remaining + - Useful for verifying that your API key is working + - **GridSlice** - Splits a grid image (such as 2×2 or 3×3) into individual images for downstream processing. @@ -50,18 +61,30 @@ This node pack currently includes the following nodes: Each node has its own documentation page under `web/docs/` with detailed inputs, outputs, and usage examples. ## About Kie.ai -Kie.ai is a unified API and model marketplace for image, video, and audio generation. This project is community-maintained and not affiliated with Kie.ai. Learn more at https://kie.ai/. +Kie.ai is a unified API and model marketplace for image, video, and audio generation. This project is community-maintained and not affiliated with Kie.ai. Learn more at [https://kie.ai](https://kie.ai). ## Credits and usage Kie.ai uses a credit-based model for requests. There is no subscription requirement, and pay-as-you-go usage is supported. +## API Key Setup + +To use these nodes, you must provide your own Kie.ai API key. + +**Steps:** +- Open `config/kie_key.example.txt` +- Paste your Kie.ai API key into the file +- Save the file as `kie_key.txt` in the same `config/` directory + +**Important:** +Do **NOT** share your API key or commit it to version control. + ## Debugging and job visibility -You can review request history and results at https://kie.ai/logs. Some models can take longer to finish; the default timeout has been increased to reduce false failures. +You can review request history and results at [https://kie.ai/logs](https://kie.ai/logs). Some models can take longer to finish; the default timeout has been increased to reduce false failures. ## Sponsorship / Development This project is developed and maintained with support from **Dreaming Computers** -https://dreamingcomputers.com +[https://dreamingcomputers.com](https://dreamingcomputers.com) Dreaming Computers is an independent studio exploring AI, creative tooling, and automation-driven workflows. The nodes in this pack are built from practical use cases and ongoing experimentation, and are shared with the community as they evolve.