A comprehensive Griptape Nodes library for AI-powered content generation using the Decart API. Generate and transform images and videos with cutting-edge AI models through natural language prompts.
- Image-to-Video (I2V): Convert static images into dynamic videos
- Video-to-Video (V2V): Transform and edit existing videos
- Text-to-Image (T2I): Generate high-quality images from text descriptions
- Text-to-Video (T2V): Create videos directly from text prompts
- Image-to-Video (I2V): Advanced image-to-video conversion with Pro quality
- Image-to-Image (I2I): Transform and enhance existing images
- Multiple Input Formats: Supports various artifact types and dictionary inputs
- Seamless Integration: Works within the Griptape Nodes ecosystem
- Comprehensive Logging: Built-in logging for debugging and monitoring
- Error Handling: Robust error handling with detailed feedback
- Flexible Parameters: Configurable seed, resolution, and prompt options
- Griptape Nodes installed and running
- Decart API key
-
Download the library files to your Griptape Nodes libraries directory:
# Navigate to your Griptape Nodes libraries directory cd `gtn config show workspace_directory` # Clone or download this library git clone https://github.com/your-username/griptape-nodes-library-decart.git
-
In the Griptape Nodes Editor, add the libary by following these steps.
- Open the Settings menu and navigate to the Libaries settings
- Click on + Add Library at the bottom of the settings panel
- Enter the path to the library JSON file. This will be your Griptape Nodes Workspace directory
/griptape-nodes-library-decart/decart/griptape_nodes_library.json. Remember you can check your Griptape Nodes Workspace directory withgtn config show workspace_directory - Close the Settings Panel
- Click on Refresh Libraries
- Verify installation by checking that all Decart nodes appear in your Griptape Nodes interface:
- Video/Decart category: Lucy Dev I2V, Lucy Dev V2V, Lucy Pro T2V, Lucy Pro I2V, Lucy Video Edit
- Image/Decart category: Lucy Pro T2I, Lucy Pro I2I
- Visit Decart.ai
- Sign up for an account or log in
- Navigate to the Use API section (currently bottom right of the page)
- Your API key will be displayed in the modal panel
Set up your Decart API key in Griptape Nodes:
The node will automatically look for the API key in the Griptape Nodes configuration under:
- Key Name:
"DECART_API_KEY"
You can configure this through the Griptape Nodes settings interface. Open the Settings menu and navigate to API Keys & Secrets and click on + Add Secret to add a new secret.
export DECART_API_KEY="your-api-key-here"Then restart Griptape Nodes to pick up the environment variable.
- Decart Lucy Dev I2V: Convert images to videos with development-quality processing
- Decart Lucy Dev V2V: Transform videos with development-quality processing
- Decart Lucy Pro T2I: Generate high-quality images from text prompts
- Decart Lucy Pro T2V: Create high-quality videos from text prompts
- Decart Lucy Pro I2V: Convert images to videos with professional-quality processing
- Decart Lucy Pro I2I: Transform images with professional-quality processing
- Decart Lucy Video Edit: Original video editing node (V2V functionality)
- Add nodes to your workflow by dragging from the appropriate category:
- Video/Decart: For video generation and transformation nodes
- Image/Decart: For image generation and transformation nodes
- Connect inputs based on the node type:
- Text-only nodes (T2I, T2V): Only require prompt input
- Image input nodes (I2V, I2I): Require image input + prompt
- Video input nodes (V2V): Require video input + prompt
- Configure parameters: Set prompt, seed (optional), and resolution (optional)
- Connect outputs to other nodes in your workflow
- Run your workflow to generate content
- Images: ImageUrlArtifact, ImageArtifact, or dictionary representations
- Videos: VideoUrlArtifact, VideoArtifact, or dictionary representations
"A serene mountain landscape at sunset with golden light""Portrait of a cyberpunk character with neon lighting""Abstract geometric patterns in vibrant colors"
"A time-lapse of clouds moving across the sky""Camera slowly zooming into a bustling city street""Gentle waves lapping on a tropical beach"
"Change the background to a sunset scene""Make the person wear a black leather jacket""Add rain effects to the scene""Convert to black and white with vintage film grain"
| Parameter | Type | Description | Required |
|---|---|---|---|
prompt |
string | Natural language description for generation/transformation | ✅ |
seed |
integer | Seed for reproducible generation | ❌ |
resolution |
string | Output resolution (default: "720p") | ❌ |
| Node Type | Additional Input | Type | Description |
|---|---|---|---|
| T2I, T2V | None | - | Text-only generation |
| I2V, I2I | image_input |
ImageUrlArtifact, ImageArtifact | Source image |
| V2V, Video Edit | video_input |
VideoUrlArtifact, VideoArtifact | Source video |
| Node Type | Output | Type | Description |
|---|---|---|---|
| T2I, I2I | image_output |
ImageUrlArtifact | Generated/transformed image |
| T2V, I2V, V2V, Video Edit | video_output |
VideoUrlArtifact | Generated/transformed video |
All nodes use the following shared configuration:
- Service Name:
"Decart" - API Key Environment Variable:
"DECART_API_KEY" - Base URL:
"https://api.decart.ai/v1/generate/"
| Node | API Endpoint |
|---|---|
| Lucy Dev I2V | lucy-dev-i2v |
| Lucy Dev V2V | lucy-dev-v2v |
| Lucy Pro T2I | lucy-pro-t2i |
| Lucy Pro T2V | lucy-pro-t2v |
| Lucy Pro I2V | lucy-pro-i2v |
| Lucy Pro I2I | lucy-pro-i2i |
| Lucy Video Edit | lucy-pro-v2v |
All nodes provide comprehensive API request logging for monitoring and debugging:
- Request URLs and parameters
- Response status codes and sizes
- Error messages and stack traces
- Processing times and performance metrics
griptape-nodes-library-decart/
├── decart/
│ ├── decart_lucy_dev_i2v.py # Lucy Dev I2V node
│ ├── decart_lucy_dev_v2v.py # Lucy Dev V2V node
│ ├── decart_lucy_pro_t2i.py # Lucy Pro T2I node
│ ├── decart_lucy_pro_t2v.py # Lucy Pro T2V node
│ ├── decart_lucy_pro_i2v.py # Lucy Pro I2V node
│ ├── decart_lucy_pro_i2i.py # Lucy Pro I2I node
│ ├── decart_lucy_video_edit.py # Legacy video edit node
│ └── griptape_nodes_library.json # Library metadata and configuration
├── pyproject.toml # Package configuration
└── README.md # This documentation
The library includes a griptape_nodes_library.json file that defines:
- 7 total nodes across Lucy Dev, Lucy Pro, and legacy models
- Two categories: Video/Decart and Image/Decart for organized node palette
- API key configuration requirements for DECART_API_KEY
- Node descriptions and metadata for each generation type
ValueError: DecartLucyVideoEdit_1 is missing DECART_API_KEY. Ensure it's set in the environment/config.
Solution: Ensure your API key is properly configured using one of the methods described in the API Key Setup section.
ValueError: Unsupported image/video input type: <class 'str'>
Solution: Ensure your inputs are in supported formats:
- Images: ImageUrlArtifact, ImageArtifact, or dict
- Videos: VideoUrlArtifact, VideoArtifact, or dict
- Flow: File path, URL, or base64 string
ERROR: Decart API request failed: 401 Client Error: Unauthorized
Solution: Check that your API key is valid and has sufficient credits/permissions.
Check the Griptape Nodes logs for information about the node execution. The node provides logging for all API interactions.
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request for improvements to this Griptape Nodes library.
- Fork the repository
- Make your changes to the node implementation
- Test the node within Griptape Nodes
- Submit a Pull Request with your improvements
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Griptape Community: Griptape Discord
Made with ❤️ for the Griptape community